utils/md_naming/migrate/survey.py
Krzysztof kuhy Rudnicki a10d190b65
Some checks failed
file length / file-length (push) Waiting to run
md-naming / markdown naming convention (push) Waiting to run
palette drift / palette (push) Waiting to run
design_system tests / test (push) Has been cancelled
gatelock pre-commit / pre-commit (push) Has been cancelled
gatelock tests / test (3.10) (push) Has been cancelled
gatelock tests / test (3.11) (push) Has been cancelled
gatelock tests / test (3.12) (push) Has been cancelled
web_ui tests / test (push) Has been cancelled
Add the shared markdown-naming gate and migrate utils' own docs
Markdown across every repo had accumulated a dozen ad-hoc names
(refactor_claude_todo.md x23, DESIGN_AUDIT_TODO.md, NEXT_SESSION,
HANDOFF, PLAN, SPEC) with nothing distinguishing a live task from a
finished record. An audit found docs asserting work was pending that
shipped months earlier, and one asserting completion while the work
was open.

Four namespaces now: README.md, CLAUDE*.md, DOCS*.md, TODO*.md. Task
files carry the literal "REMOVE ME AFTER FINISH" and are deleted when
the work lands.

Enforced bidirectionally -- a TODO without the marker fails, AND any
file carrying the marker that is not named TODO*.md fails. Without the
reverse rule a task can be renamed into the permanent namespace and
quietly live forever, which is the failure being fixed.

md_naming/ mirrors the file_length topology and imports its tables
(EXCLUDED_DIRS, THIRD_PARTY_REPOS, VENDORED_ANYWHERE, GENERATED_PATTERN)
rather than restating them, so the two gates cannot disagree about the
same file. 71 tests, 100% branch coverage.

stale.py warns on TODOs past 90 days but never fails: no machine can
prove a task is finished, so the honest mechanism is a nudge.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01A47aX5DJwmA3QFn3pkEWi7
2026-08-24 15:53:12 +02:00

57 lines
1.6 KiB
Python

"""Ask the gate which files it currently rejects, per repo.
Deriving the migration's worklist from the gate itself -- rather than from a
saved list -- is what keeps the two from disagreeing. A file the gate stops
rejecting drops out of the migration automatically.
"""
from __future__ import annotations
import subprocess
from pathlib import Path
from md_naming.rules import is_third_party
HOME = Path("/home/kuhy")
#: Repos that are clones of other people's work get no migration at all.
SKIP = {
"aur",
"actions-runner",
"awesome-mcp-explorer",
"byox-ladder",
"untools",
"llama_cpp_dart_local",
}
def kuhy_repos() -> list[Path]:
"""Every git repo directly under ~ that is kuhy's own work."""
found = []
for entry in sorted(HOME.iterdir()):
if not (entry / ".git").exists():
continue
if entry.name in SKIP or is_third_party(entry):
continue
found.append(entry)
return found
def gate_violations() -> list[Path]:
"""Files the naming gate rejects, across every kuhy-owned repo."""
checker = HOME / "utils" / "scripts" / "check_md_naming.sh"
found: list[Path] = []
for repo in kuhy_repos():
result = subprocess.run(
["bash", str(checker), "--all"],
cwd=repo,
capture_output=True,
text=True,
check=False,
)
for line in result.stderr.splitlines():
if "name must start with" not in line:
continue
found.append(Path(line.split(":")[0].strip()))
return found