testsAndMisc/docs/superpowers/evidence/md-naming-namespaces-2026-08-24.json
Krzysztof kuhy Rudnicki f15f00f3fe Re-point paths for the ~ reorganisation (home-tidy)
Also bumps the 16 meta/requirements pins the freshness gate flagged
(anthropic 1.5.0, numpy 2.5.3, pytest-randomly 5, flake8-bugbear 26.9.9,
ruff 0.16.7, pyright 1.1.414, selenium 4.49.0, hypothesis 6.168.0, lxml
6.1.3, pipdeptree 4.2.5, the two types-* stubs) and Flutter 3.47.3 in
meta/.fvmrc. One test still expected the pre-move ~/mcp-servers path.

The pre-commit hook fed .zsh files to shfmt and shellcheck, neither of
which parses zsh (SC2148/SC1071), so no zsh file could be committed since
the hook was tightened on 2026-08-22; those now get `zsh -n` instead. The
hook's own shfmt pass also staged its reformat of 8 shell files.

CI_GREEN_SKIP because main is red on exactly the dependency-freshness
finding this commit fixes, which is the documented use of that flag.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AwtowrowDXx6ccmWVPkCaF
2026-09-11 20:50:19 +02:00

49 lines
2.9 KiB
JSON

{
"intent": "Rename this repo's markdown onto the four shared namespaces (README.md / CLAUDE*.md / DOCS*.md / TODO*.md) and gate them, so a future session can tell a live task from a finished record without reading the file to find out.",
"scope": [
"40 markdown files renamed via git mv (history preserved)",
"scripts/check_md_naming.sh: thin shim delegating to kuhyx/utils",
".pre-commit-config.yaml: adds the md-naming hook",
".github/workflows/md-naming.yml: same gate on push/PR",
"Non-goal: executing the outstanding work these TODO files describe",
"Non-goal: any change to source code, tests or build config"
],
"changes": [
"Task files became TODO-<slug>.md and gained the literal line 'REMOVE ME AFTER FINISH'; record files became DOCS-<slug>.md with no marker.",
"Classification was by file CONTENT, not filename: RESTRUCTURE_HANDOFF.md and INSTALLER_FIX_TASK.md are settled records (DOCS), while docs/superpowers/plans/2026-05-01-phone-focus-recovery.md is still a task (TODO).",
"Deleted refactor_claude_todo.md and refactor_claude_todo_resume.md: the 250-line gate exits 0 in this repo, so the work they describe is provably finished.",
"Inbound references to the renamed files were rewritten in the same commit."
],
"verification": [
{
"command": "bash scripts/check_md_naming.sh --all",
"result": "pass",
"evidence": "exit 0; 0 problems across the whole tree"
},
{
"command": "pre-commit run md-naming --all-files",
"result": "pass",
"evidence": "markdown naming convention.....Passed"
},
{
"command": "bash scripts/check_file_length.sh --all",
"result": "pass",
"evidence": "exit 0 -- the basis for deleting both refactor todos"
},
{
"command": "python3 -m pytest md_naming/tests/ (in ~/src/utils)",
"result": "pass",
"evidence": "71 passed; 100% branch coverage on the gate"
}
],
"risks": [
"A rename breaks an inbound link not caught by the reference sweep. Mitigated: the sweep covered ~/.claude/CLAUDE.md, rules/, skills/, memory/ and every tracked .md; a bare-basename match was deliberately narrowed after a dry run showed it would corrupt vendored node_modules files.",
"A doc classified TASK is actually finished, or vice versa. Mitigated: verdicts came from content audits cross-checked against repo code, and are recorded in ~/src/utils/md_naming/migrate/classify.py.",
"The gate depends on kuhyx/utils being present; CI checks it out, and the shim fails loudly with install instructions if it is missing."
],
"rollback": [
"git revert the commit -- every rename is a git mv, so history follows and the revert restores the original names.",
"After rollback, confirm bash scripts/check_md_naming.sh --all is no longer wired by removing the md-naming hook from .pre-commit-config.yaml and deleting .github/workflows/md-naming.yml."
]
}