{
  "checker": {
    "claims": [
      {
        "claim": "Starting serverpeek serves the monitoring dashboard on the README default port 8080 (localhost)",
        "command": "<guest-path> --host 127.0.0.1 --port 8080",
        "evidence": "<title>Server Monitor</title>\n<style>\n/* ---- Reset & Base ---- */\n*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }\n\n:root {\n    --bg-primary: #0d1117;\n    --bg-secondary: #161b22;\n    --bg-card: #1c2129;\n    --bg-hover: #252c35;\n    --border: #30363d;\n    --text-primary: #e6edf3;\n    --text-secondary: #8b949e;\n    --text-dim: #6e7681;\n    --accent-blue: #58a6ff;\n    --accent-green: #3fb950;\n    --accent-yellow: #d29922;\n    --accent-red: #f85149;\n    --accent-purple: #bc8cff;\n    --accent-cyan: #39d2c0;\n    --bar-bg: #21262d;\n    --font-mono: 'SF Mono', 'Cascadia Code",
        "expected": "dashboard page with Server Monitor title",
        "input": "GET / on 127.0.0.1:8080",
        "kind": "claim",
        "outcome": "Real input produced the expected result: <title>Server Monitor</title>",
        "source": "Then open [http://localhost:8080](http://localhost:8080) in your browser.",
        "source_checked": true,
        "source_file": "README.md",
        "verdict": "yes"
      },
      {
        "claim": "The --port option moves the dashboard to the given port",
        "command": "<guest-path> --host 127.0.0.1 --port 9090",
        "evidence": "<title>Server Monitor</title>\n<style>\n/* ---- Reset & Base ---- */\n*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }\n\n:root {\n    --bg-primary: #0d1117;\n    --bg-secondary: #161b22;\n    --bg-card: #1c2129;\n    --bg-hover: #252c35;\n    --border: #30363d;\n    --text-primary: #e6edf3;\n    --text-secondary: #8b949e;\n    --text-dim: #6e7681;\n    --accent-blue: #58a6ff;\n    --accent-green: #3fb950;\n    --accent-yellow: #d29922;\n    --accent-red: #f85149;\n    --accent-purple: #bc8cff;\n    --accent-cyan: #39d2c0;\n    --bar-bg: #21262d;\n    --font-mono: 'SF Mono', 'Cascadia Code",
        "expected": "dashboard served on port 9090",
        "input": "--port 9090",
        "kind": "claim",
        "outcome": "Real input produced the expected result: <title>Server Monitor</title>",
        "source": "serverpeek --port 9090        # Custom port",
        "source_checked": true,
        "source_file": "README.md",
        "verdict": "yes"
      }
    ],
    "cycle_checks": [
      {
        "claim": "Scheduled or looping main behavior",
        "command": "",
        "evidence": "Inspected README.md, docs/mkdocs/usage.md, main.go and internal/server.go. The only periodic behaviour is the always-on collector goroutine (updateInterval = 2 * time.Second, internal/server.go line 65) that runs while the server is up; it is not a cron, --once or --now trigger, and there is no documented manual cycle command to run.",
        "expected": "identify the product trigger",
        "input": "source inspection",
        "kind": "cycle",
        "outcome": "Inspected README.md, docs/mkdocs/usage.md, main.go and internal/server.go. The only periodic behaviour is the always-on collector goroutine (updateInterval = 2 * time.Second, internal/server.go line 65) that runs while the server is up; it is not a cron, --once or --now trigger, and there is no documented manual cycle command to run.",
        "source": "repository entry points",
        "verdict": "yes"
      }
    ],
    "details": {
      "argv": [
        "<guest-path>",
        "--host",
        "127.0.0.1",
        "--port",
        "8080"
      ],
      "bytes": 31979,
      "kind": "http",
      "response_checked": true,
      "response_excerpt": "<title>Server Monitor</title>\n<style>\n/* ---- Reset & Base ---- */\n*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }\n\n:root {\n    --bg-primary: #0d1117;\n    --bg-secondary: #161b22;\n    --bg-card: #1c2129;\n    --bg-hover: #252c35;\n    --border: #30363d;\n    --text-primary: #e6edf3;\n    --text-secondary: #8b949e;\n    --text-dim: #6e7681;\n    --accent-blue: #58a6ff;\n    --accent-green: #3fb950;\n    --accent-yellow: #d29922;\n    --accent-red: #f85149;\n    --accent-purple: #bc8cff;\n    --accent-cyan: #39d2c0;\n    --bar-bg: #21262d;\n    --font-mono: 'SF Mono', 'Cascadia Code",
      "scope": "product operation",
      "status": 200,
      "url": "http://127.0.0.1:8080/",
      "working": true
    },
    "evidence_strength": "readme_checked",
    "example_checks": [
      {
        "claim": "usage help documents the serverpeek options",
        "command": "<guest-path> --help",
        "deferred": false,
        "evidence": "usage: serverpeek [-h] [--version] [--license] [-H HOST] [-p PORT]\n\nLive-updating web dashboard for server monitoring.\n\noptions:\n  -h, --help             show this help message and exit\n  --version              show version and exit\n  --license              show licence information and exit\n  -H, --host HOST        address to bind to (default: 0.0.0.0)\n  -p, --port PORT        port to listen on (default: 8080)",
        "expected": "help text with options section",
        "input": "serverpeek --help",
        "kind": "example",
        "outcome": "command completed successfully",
        "returncode": 0,
        "source": "docs/mkdocs/usage.md",
        "verdict": "yes"
      }
    ],
    "status": "PASS"
  },
  "deviations": [
    "Used the PyPI wheel serverpeek 1.4.0 as the README Quick Start prescribes, rather than building the pinned Go source at 8a336fc (Go toolchain not used; make build needs uv/bin2whl and wj-publish tooling). The pinned commit was fetched and checked out via git fetch/reset --mixed afterwards; the PyPI version may not exactly match the pinned commit.",
    "README says to open a browser at localhost:8080; no browser was used, the dashboard was verified with HTTP requests instead.",
    "The first HTTP probe against /api/snapshot failed in the checker because the snapshot endpoint can return an empty body before the first 2-second collector sample; the probe was changed to the static dashboard page at / (expected_text <title>Server Monitor</title>). This is a checker-timing limitation for that endpoint, not a product failure.",
    "Initial --help-only claim was rejected by the checker as not establishing working behavior; replaced with a --port 9090 HTTP claim.",
    "Usage example in docs/mkdocs/usage.md run only as --help. The repository has no test suite (no *_test.go files), and no CI test commands were run.",
    "pkill/pattern-based kills of the server briefly killed the exec wrapper (returncode 255); cleaned up via /proc PID checks instead. No leftover server processes remain."
  ],
  "fault_owner": null,
  "main_blocker": null,
  "operation": "Install serverpeek from PyPI in a Python 3.12 venv and run the README `serverpeek` dashboard server, then fetch the dashboard over HTTP (GET / on 127.0.0.1:8080, plus --port 9090 on 127.0.0.1)",
  "operation_scope": "Linux x86_64 Ubuntu 24.04 guest, Python 3.12.3, loopback only, no browser used (curl used instead), no credentials or database needed, default port 8080 and --port 9090",
  "outcome": "working",
  "plain_failure": null,
  "steps": [
    "python3 -m venv <guest-path>",
    "<guest-path> install serverpeek  (installed serverpeek 1.4.0 from PyPI, per README Quick Start 'pip install serverpeek')",
    "<guest-path> --help",
    "<guest-path> --host 127.0.0.1 --port 8080  (README Run section; serves Server Monitor dashboard)",
    "curl http://127.0.0.1:8080/ and /api/snapshot returned the dashboard and a live JSON snapshot (platform Linux)",
    "<guest-path> --host 127.0.0.1 --port 9090 (README Options --port) served the dashboard on 9090"
  ],
  "stuck_step": null,
  "suggested_fix": "None required for the working path. Optional: make the /api/snapshot endpoint return a complete snapshot (or 503) before the first collector sample so early requests do not return an empty body."
}