WUT_Computer_Science/TODO-refactor-remaining.md

TODO: remaining work on the gate refactor

REMOVE ME AFTER FINISH

What is done, what is not, and the real numbers. Companion to TODO-file-length-250.md, which parks one specific blocking decision.

Done

Area	State
Vendored manifest	gates/vendored.txt, mirrored into ~/utils (kuhyx/utils@a4a3e0a)
Build artifacts	189 untracked, .gitignore closed, 0 tracked-but-ignored files
no-binaries gate	Path-scoped .binary-allowlist; verified blocking AND passing
Markdown	4 namespaces, all under 250 lines, CLAUDE.md written
pre-commit	12 hooks, green on all files
pre-push	pre-commit install --hook-type pre-push via install.sh
GitHub CI	pre-commit + md-naming, both green. Actions had been DISABLED at repo level
run.sh	Root harness + 44 course runners over one shared library
Runnability	38 runnable / 5 no-code / 1 blocked, recorded in DOCS-runnability.md

Not done, with honest sizes

1. Python linting — 9,281 ruff findings

Measured with the fleet config (select = ["ALL"], the five standard ignores):

Rule	Count	Nature
Q000 bad-quotes	2050	auto-fixable
ANN001/ANN201 missing annotations	1671	manual
E501 line-too-long	628	mostly manual
T201 print	316	needs a decision per script
D1xx missing docstrings	~600	manual
W291/W293 whitespace	431	auto-fixable
everything else	~3600	mixed

Roughly 3,000 are auto-fixable and ~6,000 are hand work. The auto-fixable pass should be its own commit so the manual diff stays reviewable.

Blocked on: nothing. Start with ruff check --fix on the safe rules, then add pyproject.toml and the ruff/mypy hooks in the same commit as the last fix (a gate must not land before its subject is clean).

2. Coverage — 19 tests for ~28k lines

gates/coverage.tsv (per-directory floors, target always 100, floors may only rise) is designed but not written. Nothing exists for the non-Python languages yet. This is the largest remaining item by a wide margin and is measured in weeks.

3. Dependency freshness

9 requirements.txt, 5 package.json, 7 pom.xml, 1 .csproj, none pinned. The upgrade and the gate must land in the SAME commit or the repo is instantly and permanently red -- see the warning in ~/utils/scripts/install_dependency_freshness_gate.sh.

4. The 250-line cap

73 files still over. Breakdown: 27 .txt (blocked -- see TODO-file-length-250.md), 19 .tex, 10 .py, 9 .cpp, 4 .c, 2 .java. The .tex splits are \input{} per section, and the acceptance test is that the rebuilt PDF is unchanged. Do not split the source files before their tests exist -- splitting untested code is the highest-risk action here.

5. File-rewriting hooks

trailing-whitespace and end-of-file-fixer are deliberately absent. They will touch hundreds of submitted coursework files, so they want their own reviewed commit rather than being buried in a config change.

6. Two courses still fail run

• Programming/PORR -- its pytest suite solves systems up to 10000x10000 and runs for many minutes at full CPU. Under the 2G/2-core cap it will be OOM-killed rather than finish. It needs either a smaller default parameter set for run, or to be marked as a deliberately heavy target.
• Programming/ZPOB -- latexmk exits 12 from bibtex even though esej.pdf is produced. Probably a missing/!stale .bib entry; needs a clean-room rebuild to see the first real error rather than the cached one.

Standing rule

A gate lands only once the thing it gates is clean, so pre-commit run --all-files is green at every commit. Every hook still missing from .pre-commit-config.yaml is listed there with what blocks it.