{
  "intent": "Bring python_pkg/wsg_grabber/net.py under the 250-line file cap by separating the media-transfer machinery from the JSON/session half, keeping net.download, net.Transfer, net.digest_of and net.size_of reachable at their existing paths.",
  "scope": [
    "python_pkg/wsg_grabber/net.py",
    "python_pkg/wsg_grabber/_download.py (new)",
    "python_pkg/wsg_grabber/_reject.py (new)",
    "Non-goal: no behaviour change, no test changes, no change to retry/resume semantics"
  ],
  "changes": [
    "Moved the Transfer dataclass, download(), _stream(), _over_budget() and _write_body() into _download.py; net.py keeps build_session() and get_json().",
    "Moved the HTTP status classifier into _reject.py and renamed it _rejection -> classify, since it is now imported across a module boundary and a leading underscore would be a private-name import.",
    "Moved digest_of() down into _download.py because _stream() needs it: leaving it in net.py while _download imported it created a genuine runtime import cycle. net.py re-exports it, so net.digest_of still works.",
    "size_of() lives in _reject.py and is re-exported through _download and net, so all three existing call paths resolve.",
    "net.py re-exports Transfer/digest_of/download/size_of through __all__.",
    "net.py 335 -> 109 lines; _download.py 205; _reject.py 96. All three under the cap."
  ],
  "verification": [
    {
      "command": "PYTHONPATH=. python3 -c \"from python_pkg.wsg_grabber import net; [getattr(net, n) for n in net.__all__]; print(net.digest_of(b''))\"",
      "result": "pass",
      "evidence": "All six __all__ names resolve and net.digest_of(b'') returns 1B2M2Y8AsgTpgAmY7PhCfg==, the known base64 MD5 of the empty string. This also proves the net -> _download -> _reject import chain has no runtime cycle."
    },
    {
      "command": "pre-commit run --files python_pkg/wsg_grabber/net.py python_pkg/wsg_grabber/_download.py python_pkg/wsg_grabber/_reject.py",
      "result": "pass",
      "evidence": "Clean on the second run with no output after filtering Passed/Skipped. The first run had ruff autofix 15 dead imports left behind by the move (F401/I001/TC005); the __all__ entries protected the re-exports from that same autofix, and net.__all__ was re-verified as resolving afterwards."
    }
  ],
  "risks": [
    "ruff's F401 autofix removed 11 imports from net.py in one pass. Anything re-exported must be listed in __all__ or it would be deleted silently; verified by resolving net.__all__ after the autofix ran.",
    "_reject.py type-references Transfer from _download while _download imports classify from _reject; this is only non-circular because the Transfer reference sits under TYPE_CHECKING."
  ],
  "rollback": [
    "git revert the commit; net.py returns to its 335-line form and _download.py / _reject.py are deleted.",
    "After rollback, run python3 -m pytest python_pkg/wsg_grabber/tests/ -q to confirm the suite still passes."
  ]
}