Resolve Ruff 0.16 findings

[xeophon]

Overview

Updates the repository for Ruff 0.16's expanded default rule set across v1 code, legacy surfaces, tests, environments, and documentation examples.

Details

• Applies minimal code changes for v1 findings, including isolated mutable defaults, corrected exception types, import cleanup, and explicit subprocess behavior.
• Preserves intentional framework exception boundaries with narrow rule-specific suppressions.
• Adds file-level Ruff exemptions to legacy v0 code and tests while keeping v1 code fully checked.
• Formats Python examples embedded in Markdown using the Ruff 0.16 formatter.
• Leaves project dependencies, lockfiles, and uv policy unchanged.

---

Note

Low Risk
Changes are overwhelmingly lint, formatting, and defensive defaults; the few behavior tweaks (mutable defaults, closure capture, subprocess/async exec) are localized and low blast radius.

Overview
Brings the tree in line with Ruff 0.16’s expanded defaults: most legacy v0 packages, tests, and CLI shim modules get a file-level # ruff: noqa so CI can pass without rewriting those surfaces, while v1 and example environments are updated in place.

In v1 and tasksets, the substantive fixes are mutable Pydantic defaults switched to Field(default_factory=...) (judges, retries, env server legacy args, echo phrases, wiki judges, etc.), import / API hygiene (sorted __all__, Self, pairwise, ClassVar on class-level spec lists), and narrow lint-driven behavior tweaks such as TypeError for wrong-type validation, explicit subprocess check=False, and asyncio.to_thread for blocking shell in Terminus2’s local exec. Framework boundaries that intentionally catch broad exceptions are kept but annotated with targeted # noqa: BLE001 (and similar) instead of being refactored away.

Docs and README Python snippets are reformatted to match the new formatter; example envs get small correctness fixes (e.g. alphabet sort sort_key closure over by_first, proposer–solver JSON answer type errors). Tests pick up the same patterns (Field for list defaults, subprocess.run(..., check=False)).

^{Reviewed by Cursor Bugbot for commit a3467d6. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Fix mutable default arguments and resolve Ruff 0.11 linting findings across the codebase

• Fixes shared mutable defaults in Pydantic models and dataclasses across many files by replacing list/dict literals with Field(default_factory=...), preventing cross-instance state mutation in models like NetworkPolicyConfig, RetryConfig, TaskConfig, Criterion, and others.
• Suppresses Ruff lint warnings using # ruff: noqa file-level directives on ~100 files where wholesale suppression is preferred over inline fixes.
• Adds targeted # noqa: BLE001 inline comments to intentional broad except Exception handlers rather than removing them.
• Changes several ValueError raises to TypeError in validation paths (e.g. _check_borrowed_placement, Harness.resolve_prompt, EgressProxy._handle, CodexHarness.resume, AgenticJudgeEnv).
• Fixes EnvClient to catch built-in TimeoutError instead of asyncio.TimeoutError, and wraps a blocking subprocess.run in asyncio.to_thread in LocalEnvironment.exec.

^{Macroscope summarized a3467d6.}

[macroscopeapp]

Approvability

Verdict: Approved

Purely mechanical linting and formatting changes to resolve Ruff 0.16 findings. All modifications are non-behavioral: import reordering, whitespace fixes, noqa annotations, and Pydantic best-practice patterns for mutable defaults.

^{You can customize Macroscope's approvability policy. Learn more.}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b47c50e0a0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".