{
  "checker": {
    "claims": [
      {
        "claim": "blacken-docs exits nonzero when a file would be modified",
        "command": "blacken-docs --check <guest-path>",
        "evidence": "Requires a rewrite.\n",
        "expected": "exit code 1 and a rewrite-needed message",
        "input": "<guest-path> with an unformatted python block",
        "kind": "claim",
        "outcome": "Real input produced the expected result: Requires a rewrite.",
        "returncode": 1,
        "source": "If any file is modified, ``blacken-docs`` exits nonzero.",
        "source_checked": true,
        "source_file": "README.rst",
        "verdict": "yes"
      },
      {
        "claim": "blacken-docs supports reStructuredText files",
        "command": "blacken-docs --check <guest-path>",
        "evidence": "Requires a rewrite.\n",
        "expected": "rewrite-needed message for the rst file",
        "input": "<guest-path> with an unformatted python code-block",
        "kind": "claim",
        "outcome": "Real input produced the expected result: Requires a rewrite.",
        "returncode": 1,
        "source": "It supports Markdown, reStructuredText, and LaTex files.",
        "source_checked": true,
        "source_file": "README.rst",
        "verdict": "yes"
      }
    ],
    "cycle_checks": [
      {
        "claim": "Scheduled or looping main behavior",
        "command": "",
        "evidence": "Inspected README.rst, pyproject.toml scripts entry (blacken_docs:main) and src/blacken_docs/__main__.py entry points: blacken-docs is a one-shot CLI that processes the filenames given and exits. No scheduler, cron, loop, webhook, daemon or --once/--now mode is documented or present.",
        "expected": "identify the product trigger",
        "input": "source inspection",
        "kind": "cycle",
        "outcome": "Inspected README.rst, pyproject.toml scripts entry (blacken_docs:main) and src/blacken_docs/__main__.py entry points: blacken-docs is a one-shot CLI that processes the filenames given and exits. No scheduler, cron, loop, webhook, daemon or --once/--now mode is documented or present.",
        "source": "repository entry points",
        "verdict": "yes"
      }
    ],
    "details": {
      "argv": [
        "blacken-docs",
        "--check",
        "<guest-path>"
      ],
      "kind": "cli",
      "needs_browser": false,
      "needs_credentials": false,
      "returncode": 1,
      "scope": "product operation",
      "stderr": "",
      "stdout": "<guest-path> Requires a rewrite.",
      "working": true
    },
    "evidence_strength": "readme_checked",
    "example_checks": [
      {
        "claim": "Repository test suite passes (tox.ini testenv command, without coverage wrapper)",
        "command": "<guest-path> -W error::ResourceWarning -W error::DeprecationWarning -m pytest -p no:cacheprovider tests",
        "deferred": false,
        "evidence": "============================= test session starts ==============================\nplatform linux -- Python 3.12.3, pytest-9.1.1, pluggy-1.7.0\nUsing --randomly-seed=1010565475\nrootdir: <guest-path>\nconfigfile: pyproject.toml\nplugins: randomly-5.0.0, platformdirs-4.13.6\ncollected 76 items\n\ntests/test_blacken_docs.py ............................................. [ 59%]\n...............................                                          [100%]\n\n============================== 76 passed in 0.84s ==============================",
        "expected": "all tests pass",
        "input": "tests/",
        "kind": "example",
        "outcome": "command completed successfully",
        "returncode": 0,
        "source": "tox.ini [testenv] commands",
        "verdict": "yes"
      },
      {
        "claim": "Check a documentation file without rewriting it",
        "command": "blacken-docs --check README.rst",
        "deferred": false,
        "evidence": "",
        "expected": "exit 0, file already formatted",
        "input": "README.rst",
        "kind": "example",
        "outcome": "command completed successfully with no output",
        "returncode": 0,
        "source": "README.rst Usage section",
        "verdict": "yes"
      }
    ],
    "status": "PASS"
  },
  "deviations": [
    "Installed from the local source checkout with pip into a venv rather than from PyPI, so the tested code is the snapshot in <guest-path>",
    "Snapshot is not a git checkout (no .git), so the pinned commit 8e7705218838da988c103d00ab6ecdd67dea7c37 could not be verified and no git fetch/reset was run.",
    "tox was not used; the same pytest command was run directly with the tox warning flags and without the coverage wrapper, using -p no:cacheprovider so no cache files were written to the checkout.",
    "Only Python 3.12 was tested; 3.11 and 3.13-3.15 were not run.",
    "The checker default source file is README.md; the claims set source_file to README.rst because that is the repo README.",
    "In-place rewrite was checked by hand on a scratch copy, not as a replayed claim, because a second replay would no longer find anything to rewrite."
  ],
  "fault_owner": null,
  "main_blocker": null,
  "operation": "Run blacken-docs --check on Markdown and reStructuredText files and get the documented nonzero exit with a rewrite-needed message; run the repo test suite",
  "operation_scope": "Local CLI from the source checkout installed into <guest-path> (Python 3.12.3, README supports 3.11-3.15). No browser, credentials or network service needed.",
  "outcome": "working",
  "plain_failure": null,
  "steps": [
    "curl $CDP_URL/json/version returned HTTP 200 (browser not needed by this CLI)",
    "python3 -m venv <guest-path> (Python 3.12.3)",
    "<guest-path> -m pip install <guest-path> (installed blacken-docs 1.20.0 with black 26.10.1)",
    "blacken-docs sample.md (in <guest-path>) rewrote the python block in place and exited 1, as documented",
    "blacken-docs --check <guest-path> and check.rst: exit 1 with 'Requires a rewrite.'",
    "blacken-docs --check README.rst on the repo README: exit 0",
    "pytest tests with tox.ini warning flags: 76 passed"
  ],
  "stuck_step": null,
  "suggested_fix": "None required; the tool works as documented."
}