mirror of
https://github.com/kuhyx/utils.git
synced 2026-11-10 20:27:15 +01:00
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
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
114 lines
6.6 KiB
Python
114 lines
6.6 KiB
Python
"""Classify each legacy markdown file as a task (TODO) or a record (DOCS).
|
|
|
|
Filename alone is not a reliable signal and neither is directory: this corpus
|
|
contains `docs/todo/workstream-d-scoping-findings.md`, which lives under
|
|
`docs/todo/` and is explicitly a findings record ("No code was written or
|
|
modified in any repo for this pass"), and `INSTALLER_FIX_TASK.md`, which reads
|
|
as pending but shipped in commit 4c426eae.
|
|
|
|
So the audited files carry an explicit verdict here, sourced from three
|
|
Explore audits cross-checked against exit codes where one exists. Anything not
|
|
listed falls back to a conservative heuristic and is reported for review rather
|
|
than renamed silently.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
#: Files the audits proved are still outstanding work -> TODO*, marker added.
|
|
TASKS: dict[str, str] = {
|
|
# 250-line cap refactors. Verified by running the shared gate per repo:
|
|
# every one of these exits 1 with violations still present.
|
|
"atomichabits/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"CV/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"dufs-cloud/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"epopeja_karta/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"europe-county-map/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"habit_stack/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"home_inventory/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"i3wm-mcp/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"konbini-67/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"kuhytrack/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"leetcode-guard/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"macro-cam/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"mcp-servers/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"opengameart-mcp/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"screen-locker/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"steam-backlog-enforcer/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"steam-game-installer/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"wake-alarm/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"wiki-kb/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
"yay-mcp/refactor_claude_todo.md": "TODO-file-length-250.md",
|
|
# Design audits with violations the audit re-confirmed still present.
|
|
"habit_stack/DESIGN_AUDIT_TODO.md": "TODO-design-audit.md",
|
|
"todo/DESIGN_AUDIT_TODO.md": "TODO-design-audit.md",
|
|
"testsAndMisc/DESIGN_AUDIT_TODO.md": "TODO-design-audit.md",
|
|
# dopamine-ux programme: 00-INDEX records 8 of 9 "not started".
|
|
"diet-guard/prompts/dopamine-ux-diet-guard.md": "TODO-dopamine-ux-diet-guard.md",
|
|
"dufs-cloud/prompts/dopamine-ux-07-theme.md": "TODO-dopamine-ux-07-theme.md",
|
|
"dufs-cloud/prompts/dopamine-ux-08-motion.md": "TODO-dopamine-ux-08-motion.md",
|
|
"screen-locker/prompts/dopamine-ux-04-screen-locker.md": "TODO-dopamine-ux-04-screen-locker.md",
|
|
"screen-locker/prompts/dopamine-ux-05-workout-app.md": "TODO-dopamine-ux-05-workout-app.md",
|
|
"todo/prompts/dopamine-ux-todo.md": "TODO-dopamine-ux-todo.md",
|
|
"wake-alarm/prompts/dopamine-ux-wake-alarm.md": "TODO-dopamine-ux-wake-alarm.md",
|
|
"utils/prompts/dopamine-ux-02-structural-check.md": "TODO-dopamine-ux-02-structural-check.md",
|
|
# pylint-to-ten: measured 8.53 and 8.77 against a target of 10.00.
|
|
"leetcode-guard/prompts/pylint-to-ten.md": "TODO-pylint-to-ten.md",
|
|
"steam-backlog-enforcer/prompts/pylint-to-ten.md": "TODO-pylint-to-ten.md",
|
|
"utils/gatelock/prompts/pylint-to-ten.md": "TODO-pylint-to-ten.md",
|
|
"steam-backlog-enforcer/prompts/refactor-250-continue.md": "TODO-refactor-250-continue.md",
|
|
"screen-locker/todo_fix_pylint_10_prompt.md": "TODO-pylint-to-ten.md",
|
|
"screen-locker/todo_finish_dart_250_prompt.md": "TODO-finish-dart-250.md",
|
|
# Other confirmed-outstanding work.
|
|
"europe-county-map/docs/toDo.md": "TODO-deferred-mechanics.md",
|
|
"lyricanki/NEXT_SESSION.md": "TODO-second-song-and-language.md",
|
|
"osu-automapper/NEXT_SESSION.md": "TODO-sweep-writeup.md",
|
|
"screen-locker/docs/android-ui-automation-task.md": "TODO-android-ui-mcp-wrapper.md",
|
|
"utils/vmbox/DISCOVERY_TEST.md": "TODO-discovery-test.md",
|
|
"roadside-assistance/TODO.md": "TODO.md",
|
|
}
|
|
|
|
#: Files the audits found are records, findings or settled decisions.
|
|
#: Permanent, no marker. Includes the three that read as pending but are not.
|
|
RECORDS: dict[str, str] = {
|
|
"macro-cam/STAGE0_FINDINGS.md": "DOCS-stage0-findings.md",
|
|
"macro-cam/PIXEL_BUDGET.md": "DOCS-pixel-budget.md",
|
|
"testsAndMisc/RESTRUCTURE_HANDOFF.md": "DOCS-restructure-handoff.md",
|
|
"testsAndMisc/INSTALLER_FIX_TASK.md": "DOCS-installer-fix.md",
|
|
"testsAndMisc/docs/restructure-live-state.md": "DOCS-restructure-live-state.md",
|
|
"testsAndMisc/docs/dns-filtering-parked.md": "DOCS-dns-filtering-parked.md",
|
|
"screen-locker/docs/todo/workstream-d-scoping-findings.md": "DOCS-workstream-d-scoping-findings.md",
|
|
"screen-locker/docs/todo/workstream-c-github-sync-workout-data.md": "DOCS-workstream-c-github-sync.md",
|
|
"screen-locker/docs/todo/workstream-d-shared-crdt-transport.md": "DOCS-workstream-d-shared-crdt-transport.md",
|
|
"utils/vmbox/SESSION_RESULTS.md": "DOCS-session-results.md",
|
|
"utils/vmbox/NEXT_SESSION_PROMPT.md": "DOCS-vmbox-session-jobs.md",
|
|
"dufs-cloud/SUBTITLE_INVESTIGATION.md": "DOCS-subtitle-investigation.md",
|
|
"leetcode-guard/INCIDENT-2026-08-05-no-way-to-solve.md": "DOCS-incident-2026-08-05.md",
|
|
"yay-mcp/docs/register.md": "DOCS-register.md",
|
|
"europe-county-map/RESEARCH.md": "DOCS-research.md",
|
|
"roadside-assistance/PLAN.md": "DOCS-plan.md",
|
|
"diet-guard/prompts/crdt-sync-session-reuse.md": "DOCS-crdt-sync-session-reuse.md",
|
|
}
|
|
|
|
#: Audited as DONE. Deleted only where an exit code proves it; the rest are
|
|
#: reported for the user to confirm, never removed on a model's say-so.
|
|
PROVEN_DONE = (
|
|
"todo/refactor_claude_todo.md",
|
|
"utils/refactor_claude_todo.md",
|
|
"testsAndMisc/refactor_claude_todo.md",
|
|
"testsAndMisc/refactor_claude_todo_resume.md",
|
|
)
|
|
|
|
#: Claimed DONE by audit but with no exit code to prove it. Needs confirmation.
|
|
CLAIMED_DONE = (
|
|
"dufs-cloud/DESIGN_AUDIT_TODO.md",
|
|
"personal-website/DESIGN_AUDIT_TODO.md",
|
|
"steam-backlog-enforcer/DESIGN_AUDIT_TODO.md",
|
|
"wake-alarm/DESIGN_AUDIT_TODO.md",
|
|
"diet-guard/DESIGN_AUDIT_TODO.md",
|
|
"screen-locker/DESIGN_AUDIT_TODO.md",
|
|
"screen-locker/HANDOFF_2026-08-24.md",
|
|
"screen-locker/NEXT_SESSION_PROMPT.md",
|
|
"todo/MIGRATION.md",
|
|
"wake-alarm/MIGRATION.md",
|
|
)
|