run-and-fix

Pyright: Run and Fix

Run pyright on the Python code in this project and fix the errors it finds, following the rule-specific patterns in the bundled playbook.

Pattern catalog. The playbook is split across five files at ${CLAUDE_PLUGIN_ROOT}:

• reference.md — index, setup, triage, suppression policy, narrowing artifacts, documented-API preference, CI, parallel dispatch, external-finding verification, editor-autofix warning, serialization compat, config-intent principle, assert-vs-raise, consolidation pass (orchestrator-level).
• rules.md — fix recipes keyed on pyright rule name (reportOptionalMemberAccess, reportArgumentType, reportTypedDictNotRequiredAccess, …).
• libraries.md — library-stub workarounds (bitstring, scipy, tornado, matplotlib, Beanie, Supabase, litellm, pydantic, PIL, tenacity, pymongo, …).
• bugs.md — signals that pyright has uncovered a real bug (to flag for the user, not silence).
• suggestions.md — Phase 5 "Suggested improvements" procedure: signals to combine, sort order, save flow.

Read reference.md at the start of the run for the index and the triage/policy framework. Re-consult rules.md and libraries.md when triage surfaces specific rules or library names. If ${CLAUDE_PLUGIN_ROOT} isn't substituted in this context, find the files with Glob "**/pyright/reference.md" and read the siblings alongside it.

Arguments: "$ARGUMENTS"

---

Phase 1 — Parse args and verify setup

Step 1: parse $ARGUMENTS

Expected tokens, all optional:

• Positional level ∈ {basic, standard, strict}. Overrides the config's typeCheckingMode for this invocation.
• --persist — if a level is given and the run reaches zero errors, write that level back to config.
• --ratchet — climb basic → standard → strict, fixing to zero at each rung. Mutually exclusive with an explicit level; implies --persist at each rung.
• --scope <path> — restrict pyright invocation and fix work to a subpath. Default: the config's include.
• --intent <silence|improve|bugs-only> — declares the lean Phase 3 should take when fixing errors. See Phase 3 § "Apply the chosen intent" for the full, authoritative definitions. If omitted, the command prompts in Phase 2 after showing triage.
• --no-suggestions — skip the "Suggested improvements" section in Phase 5. Default: include it.