Single-source the public-surface mypy gate in [tool.mypy] instead of four hand-copied flag strings #919

Activity

1. cemililik

   added this to the Backlog — Wave 4: low, info and watch items milestone on Oct 9, 2026
2. cemililik

   added

   area: dev-toolingCode area: dev-toolingCode area: dev-tooling

   severity: lowMinor defect, inaccuracy or rough edgeMinor defect, inaccuracy or rough edge

   wave: 4Roadmap wave 4: low / info / watch, when touching the moduleRoadmap wave 4: low / info / watch, when touching the module

   source: roadmapPlanned or deferred work recorded in docs/roadmap/Planned or deferred work recorded in docs/roadmap/

   on Oct 9, 2026
3. cemililik

   added this to ForgeLM Project Planon Oct 9, 2026
4. cemililik

   added a parent issue on Oct 9, 2026

   • [Epic] Deferred work · conditions and budgets recorded in risks-and-decisions.md #929
5. cemililik

   added

   good first issueGood for newcomersGood for newcomers

   on Oct 11, 2026
6. cemililik commented on Oct 11, 2026

   

   cemililik

   on Oct 11, 2026

   CollaboratorAuthor

   More actions

   Where to start

   Thanks for taking a look. Please confirm the issue is unassigned and comment before starting so work does not overlap.

   Start with these files on development:

   • pyproject.toml
   • .github/workflows/ci.yml
   • CLAUDE.md
   • AGENTS.md
   • CONTRIBUTING.md
   • tests/test_guard_wiring.py

   Move the existing strict/follow_imports/files values into [tool.mypy], then replace the four copied flag/file lists with the same bare mypy invocation. Update guard-wiring assertions to enforce the new single source. Run python3 -m mypy and the wiring test; prove the public-surface files and strictness stay identical. Do not expand typing scope or fix internal typing debt.

   No [tool.mypy] exists at the verified SHA. The eventual issue PR includes CI changes explicitly requested by that issue; none are made in this preparation task.

   Run the focused tests:

   pytest tests/test_guard_wiring.py --no-cov

   Run these guards/checks as applicable to the changed files:

   ruff format --check tests/test_guard_wiring.py
   ruff check tests/test_guard_wiring.py
   python3 tools/check_bilingual_parity.py --strict
   python3 tools/check_bilingual_code_blocks.py --strict
   python3 tools/check_anchor_resolution.py --strict
   python3 tools/check_tr_links_prefer_mirror.py --strict
   python3 tools/check_usermanual_self_contained.py --strict
   python3 tools/check_usermanual_schema_drift.py --strict
   python3 -m mypy
   python3 tools/check_skill_mirror_parity.py --strict

   If user-facing documentation changes, update the existing Turkish mirror in the same PR; keep commands, code and terminal output in English and structurally aligned. English-only contributor standards need no new mirror.

   Open the PR against development with Fixes #919 once every finding is resolved or explicitly closed with a reason; use Refs #919 for partial work and list the resolved finding IDs.
7. cemililik

   added

   help wantedExtra attention is neededExtra attention is needed

   and removed

   good first issueGood for newcomersGood for newcomers

   on Oct 11, 2026