{
  "report_info": {
    "version": "9.0.1",
    "generated_at": "2026-04-11T17:16:12Z",
    "binary_name": "conky-status"
  },
  "binary": {
    "name": "conky-status",
    "path": "/home/kodachi/k900/dashboard/hooks/conky-status",
    "timestamp": "2026-04-11T17:16:12Z",
    "file_info": {
      "size": 3482528,
      "sha256": "7c92bdb3e6e3156db07aad383ee12b81c81f92693ef2b9f14df35969e3312ca9"
    },
    "flag_n": {
      "command": "info",
      "data": {
        "author": "Warith Al Maawali",
        "copyright": "© 2026 Linux Kodachi",
        "description": "Unified Rust gateway for Kodachi Conky data",
        "features": [
          "Bounded parallel adapter collection",
          "Unified snapshot cache with lock + atomic writes",
          "Privacy-first redaction for sensitive identifiers",
          "Compatibility aliases for legacy Conky scripts",
          "User-defined Conky command registry via JSON config",
          "Kodachi-standard CLI flags via cli-core"
        ],
        "license": "Proprietary",
        "name": "conky-status",
        "securityFeatures": {
          "authentication": "Secure authentication with certificate pinning",
          "encryption": "TLS 1.3 for all network communications",
          "inputValidation": "All inputs are validated and sanitized",
          "rateLimiting": "Built-in rate limiting for network operations"
        },
        "systemRequirements": {
          "dependencies": [
            "OpenSSL",
            "libcurl"
          ],
          "os": "Linux (Debian-based)",
          "privileges": "root/sudo for system operations"
        },
        "version": "9.0.1",
        "website": "https://www.digi77.com"
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "Boardroom-System",
        "user": "kodachi"
      },
      "status": "success",
      "timestamp": "2026-04-11T17:16:12.984420277Z",
      "version": "9.0.1",
      "warnings": []
    },
    "flag_v": {
      "command": "version",
      "data": {
        "buildDate": "2026-04-11T17:16:13.053284306Z",
        "gitCommit": "unknown",
        "name": "conky-status",
        "rustVersion": "1.82.0",
        "version": "9.0.1"
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "Boardroom-System",
        "user": "kodachi"
      },
      "status": "success",
      "timestamp": "2026-04-11T17:16:13.083673633Z",
      "version": "9.0.1",
      "warnings": []
    },
    "flag_h": {
      "command": "help",
      "data": {
        "commandCategories": [
          {
            "category": "Data",
            "commands": [
              {
                "description": "Collect and output unified conky-status snapshot",
                "examples": [
                  "./conky-status snapshot --json",
                  "./conky-status snapshot --json-pretty",
                  "./conky-status snapshot --json-human",
                  "./conky-status snapshot --cached --ttl 30",
                  "./conky-status snapshot --refresh --max-parallel 2 --timeout-ms 1500"
                ],
                "name": "snapshot",
                "options": [
                  {
                    "default": "true unless --cached is set",
                    "description": "Force refresh now",
                    "flag": "--refresh",
                    "required": false
                  },
                  {
                    "default": "false",
                    "description": "Prefer cache if fresh",
                    "flag": "--cached",
                    "required": false
                  },
                  {
                    "default": "30",
                    "description": "Cache freshness threshold",
                    "flag": "--ttl <seconds>",
                    "required": false
                  }
                ],
                "requires_sudo": false,
                "usage": "conky-status snapshot [--refresh] [--cached] [--ttl <sec>] [--max-parallel <n>] [--timeout-ms <ms>]"
              },
              {
                "description": "Get a single key value (snapshot key or user.<name> registry command)",
                "examples": [
                  "./conky-status get data.auth.group",
                  "./conky-status get ip-cache.ip",
                  "./conky-status get auth-detail.sessionid",
                  "./conky-status get data.health.score_display --default 0",
                  "./conky-status get security-status.vpn --json",
                  "./conky-status get data.system.network.interface --refresh",
                  "./conky-status get dns-cache.mode --default Unknown",
                  "./conky-status get user.hostname_short",
                  "./conky-status get user.uptime_pretty --default N/A"
                ],
                "name": "get",
                "options": [
                  {
                    "description": "Fallback value when key is missing",
                    "flag": "--default <value>",
                    "required": false
                  },
                  {
                    "default": "false",
                    "description": "Force refresh before lookup",
                    "flag": "--refresh",
                    "required": false
                  }
                ],
                "requires_sudo": false,
                "usage": "conky-status get <key> [--default <value>] [--refresh] [--ttl <sec>]  # key supports user.<name>"
              },
              {
                "description": "Get a batched subset for a panel",
                "examples": [
                  "./conky-status panel security",
                  "./conky-status panel system --json-pretty",
                  "./conky-status panel network --refresh",
                  "./conky-status panel resources",
                  "./conky-status panel gauges --json",
                  "./conky-status panel all --json-human"
                ],
                "name": "panel",
                "options": [],
                "requires_sudo": false,
                "usage": "conky-status panel <security|system|network|resources|gauges|all> [--refresh]"
              },
              {
                "description": "Manage and execute user-defined Conky commands from JSON registry",
                "examples": [
                  "./conky-status user path",
                  "./conky-status user init",
                  "./conky-status user list",
                  "./conky-status user run hostname_short",
                  "./conky-status user run uptime_pretty --json-pretty"
                ],
                "name": "user",
                "options": [],
                "requires_sudo": false,
                "usage": "conky-status user <path|init|list|run> [args]"
              }
            ]
          }
        ],
        "description": "Unified Rust gateway for Kodachi Conky data",
        "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)"
          }
        ],
        "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": "Pretty-print JSON output with indentation",
            "flag": "--json-pretty"
          },
          {
            "description": "Enhanced JSON output with improved formatting (like jq)",
            "flag": "--json-human"
          },
          {
            "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>"
          }
        ],
        "name": "conky-status",
        "usage": "conky-status [OPTIONS] [COMMAND] [ARGS]"
      },
      "errors": [],
      "metadata": {
        "executionTime": 1,
        "hostname": "Boardroom-System",
        "user": "kodachi"
      },
      "status": "success",
      "timestamp": "2026-04-11T17:16:13.156700889Z",
      "version": "9.0.1",
      "warnings": []
    },
    "flag_e": {
      "command": "examples",
      "data": {
        "categories": [
          {
            "description": "Kodachi-standard global flags and output modes",
            "examples": [
              {
                "command": "./conky-status -h",
                "description": "Show full CLI help",
                "expectedOutput": "Command/option reference"
              },
              {
                "command": "./conky-status -v",
                "description": "Show binary version",
                "expectedOutput": "conky-status version 9.0.1"
              },
              {
                "command": "./conky-status -n --json-pretty",
                "description": "Show program metadata using JSON pretty mode",
                "expectedOutput": "Envelope with info payload"
              },
              {
                "command": "./conky-status -e",
                "description": "Show comprehensive usage examples",
                "expectedOutput": "Category-based examples list"
              },
              {
                "command": "./conky-status snapshot --json-human",
                "description": "Use human-readable JSON rendering (jq-like)",
                "expectedOutput": "Enhanced JSON envelope",
                "notes": "Falls back to pretty JSON if jq is unavailable"
              }
            ],
            "id": "1_core_flags",
            "title": "Core Flags"
          },
          {
            "description": "Refresh, cache, concurrency, and timeout controls",
            "examples": [
              {
                "command": "./conky-status snapshot --json",
                "description": "Collect snapshot using default refresh behavior",
                "expectedOutput": "Envelope with meta/adapters/data"
              },
              {
                "command": "./conky-status snapshot --cached --ttl 30",
                "description": "Prefer cached snapshot if age <= 30 seconds",
                "expectedOutput": "Fast cached response when fresh"
              },
              {
                "command": "./conky-status snapshot --refresh --timeout-ms 1200",
                "description": "Force new collection with tighter adapter timeout",
                "expectedOutput": "Fresh snapshot with possible degraded adapters"
              },
              {
                "command": "./conky-status snapshot --refresh --max-parallel 6 --json-pretty",
                "description": "Override adapter concurrency budget",
                "expectedOutput": "Pretty JSON snapshot",
                "notes": "Use moderate values to avoid subprocess storms"
              }
            ],
            "id": "2_snapshot_modes",
            "title": "Snapshot Modes"
          },
          {
            "description": "Read direct snapshot key paths",
            "examples": [
              {
                "command": "./conky-status get data.auth.group",
                "description": "Read authenticated user group",
                "expectedOutput": "Group value or '?'"
              },
              {
                "command": "./conky-status get data.health.score_display --default 0",
                "description": "Read health score with default fallback",
                "expectedOutput": "Numeric score string"
              },
              {
                "command": "./conky-status get data.system.network.interface --refresh",
                "description": "Force refresh before interface lookup",
                "expectedOutput": "Interface name like ens33/wlan0"
              },
              {
                "command": "./conky-status get data.tor.torrified_onoff --json",
                "description": "Structured JSON response for a single key",
                "expectedOutput": "Envelope with key, resolved_key, value, stale"
              }
            ],
            "id": "3_get_native_keys",
            "title": "Get Native Keys"
          },
          {
            "description": "Legacy script-compatible key aliases for Conky migration",
            "examples": [
              {
                "command": "./conky-status get ip-cache.ip --default Offline",
                "description": "Effective external IP (Tor exit when torrified, direct IP otherwise)",
                "expectedOutput": "Effective IP or Offline"
              },
              {
                "command": "./conky-status get ip-public.ip --default Offline",
                "description": "Direct/public WAN IP regardless of Tor exit routing",
                "expectedOutput": "Public IP or Offline"
              },
              {
                "command": "./conky-status get auth-detail.sessionid",
                "description": "Equivalent of auth-detail.sh sessionid",
                "expectedOutput": "Masked session token or N/A"
              },
              {
                "command": "./conky-status get dns-cache.mode --default Unknown",
                "description": "Equivalent of dns-cache.sh mode",
                "expectedOutput": "DNS mode string"
              },
              {
                "command": "./conky-status get system-status.swapperc --default 0",
                "description": "Gauge-ready swap usage percent from gateway",
                "expectedOutput": "Integer 0-100"
              },
              {
                "command": "./conky-status get net-traffic.totalpercent --default 0",
                "description": "Gauge-ready total bandwidth percent (0-100)",
                "expectedOutput": "Integer 0-100",
                "notes": "Computed from total uploaded+downloaded bytes against 10 GiB scale"
              },
              {
                "command": "./conky-status get security-status.vpn --json-pretty",
                "description": "Equivalent of security-status.sh vpn",
                "expectedOutput": "JSON envelope with boolean value"
              },
              {
                "command": "./conky-status get cloud-status.cards",
                "description": "Equivalent of cloud-status.sh cards",
                "expectedOutput": "Cloud cards count or '?'"
              }
            ],
            "id": "4_get_compat_keys",
            "title": "Get Compatibility Keys"
          },
          {
            "description": "Batched panel subsets for exec/execpi integration",
            "examples": [
              {
                "command": "./conky-status panel security",
                "description": "Key=value output for security panel",
                "expectedOutput": "Multiple lines: internet/login/group/..."
              },
              {
                "command": "./conky-status panel system --json-pretty",
                "description": "System panel subset in JSON",
                "expectedOutput": "Envelope with panel data map"
              },
              {
                "command": "./conky-status panel network --refresh",
                "description": "Refresh before network panel render",
                "expectedOutput": "Updated panel key=value lines"
              },
              {
                "command": "./conky-status panel resources",
                "description": "Resource panel subset (traffic + booleans)",
                "expectedOutput": "Panel key=value lines"
              },
              {
                "command": "./conky-status panel all --json-human",
                "description": "Dump full data section in human JSON mode",
                "expectedOutput": "Large JSON envelope"
              }
            ],
            "id": "5_panel_modes",
            "title": "Panel Modes"
          },
          {
            "description": "Drop-in commands for wrapper scripts and panel configs",
            "examples": [
              {
                "command": "${exec ~/.config/kodachi/conky/scripts/ip-cache.sh ip} -> ${exec ./conky-status get ip-cache.ip --default Offline}",
                "description": "Replace legacy IP script call",
                "expectedOutput": "Same scalar value in Conky text field"
              },
              {
                "command": "${exec ~/.config/kodachi/conky/scripts/auth-detail.sh group} -> ${exec ./conky-status get auth-detail.group --default '?'}",
                "description": "Replace auth detail script call",
                "expectedOutput": "Same group text output"
              },
              {
                "command": "${exec ~/.config/kodachi/conky/scripts/dns-cache.sh ns1} -> ${exec ./conky-status get dns-cache.ns1 --default N/A}",
                "description": "Replace DNS cache script call",
                "expectedOutput": "Primary nameserver text"
              },
              {
                "command": "${execpi 20 ./conky-status panel security}",
                "description": "Use panel mode for grouped values",
                "expectedOutput": "key=value lines for panel rendering",
                "notes": "No Conky restart required to validate command output"
              }
            ],
            "id": "6_conky_integration",
            "title": "Conky Integration"
          },
          {
            "description": "Configure custom commands in JSON so Conky can call unsupported fields through the gateway",
            "examples": [
              {
                "command": "./conky-status user path",
                "description": "Show registry file path",
                "expectedOutput": "~/.config/kodachi/conky/config/user-commands.json"
              },
              {
                "command": "./conky-status user init",
                "description": "Create template registry if missing",
                "expectedOutput": "created: <path> or existing: <path>"
              },
              {
                "command": "./conky-status user list --json-pretty",
                "description": "List registered custom command names",
                "expectedOutput": "JSON list with command count"
              },
              {
                "command": "./conky-status user run hostname_short",
                "description": "Execute one configured command directly",
                "expectedOutput": "Single Conky-safe value",
                "notes": "Failed commands retry once and can fall back to stale cache/default"
              },
              {
                "command": "./conky-status get user.hostname_short --default Unknown",
                "description": "Conky-friendly key path for custom user command",
                "expectedOutput": "Scalar value from registry-backed command",
                "notes": "Also accepts custom.<name> as alias"
              },
              {
                "command": "${exec ./conky-status get user.hostname_short --default Unknown}",
                "description": "Direct Conky call without exposing command logic in bash",
                "expectedOutput": "Rendered value in panel"
              }
            ],
            "id": "7_user_command_registry",
            "title": "User Command Registry"
          },
          {
            "description": "Binary self-signature verification diagnostics and enforcement",
            "examples": [
              {
                "command": "KODACHI_FORCE_VERIFY=1 ./conky-status -v",
                "description": "Force signature check in debug builds",
                "expectedOutput": "Version output if signature verifies",
                "notes": "Fails with SECURITY error when signature is missing/invalid"
              },
              {
                "command": "KODACHI_SIG_DIR=./results/signatures ./conky-status snapshot --json",
                "description": "Use custom signature directory",
                "expectedOutput": "Snapshot output with successful startup"
              },
              {
                "command": "KODACHI_BUILD_TEST=1 ./conky-status -v",
                "description": "Skip signature check in controlled build-test mode",
                "expectedOutput": "Version output",
                "notes": "Intended for build pipeline self-tests only"
              },
              {
                "command": "./conky-status -v",
                "description": "Release behavior with mandatory signature verification",
                "expectedOutput": "Version output or SECURITY failure message"
              }
            ],
            "id": "8_signature_verification",
            "title": "Signature Verification"
          }
        ],
        "description": "Usage examples for conky-status",
        "name": "conky-status",
        "quickReference": [
          "sudo conky-status --help",
          "sudo conky-status --version",
          "sudo conky-status --info --json",
          "sudo conky-status --examples --json"
        ]
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "Boardroom-System",
        "user": "kodachi"
      },
      "status": "success",
      "timestamp": "2026-04-11T17:16:13.355766019Z",
      "version": "9.0.1",
      "warnings": []
    }
  }
}