mirror of
https://github.com/kuhyx/testsAndMisc.git
synced 2026-11-11 18:14:03 +01:00
Krzysztof kuhy Rudnicki
3cd42a4451
Two scripts and a baseline record, ahead of the archive/extract/flatten campaign. Nothing moves in this commit. report_live_state.sh enumerates everything on this machine that names an absolute path inside the repo -- 6 systemd units, 2 /etc/guard-lib plugin targets and 19 symlinks. Moving a subtree silently breaks these, so each later step repoints its own references and re-runs this with --check. check_directory_depth.sh is the 2-directory cap, modelled on check_file_length.sh. It is deliberately NOT wired into pre-commit yet: the tree has 556 violations, so enforcing it now would block every unrelated commit -- the same reason file-length-cap landed after its campaign rather than before. Run as a dry run it sizes the work: 349 of those 556 disappear with the planned removals, leaving 207 to flatten, ~130 of them under scripts/single_use. Exemptions are prefix-based (third_party/, docs/superpowers/, .github/skills/) plus the lib/ and tests/ path segments, matched as whole segments so libvirt/ and lib.sh are not caught. Capping lib/ and tests/ would put this gate in conflict with the 250-line cap and the shell-coverage ratchet, which require exactly that layout. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PJrqKERAo5QUeEHWS5Asgp
52 lines
3.6 KiB
JSON
52 lines
3.6 KiB
JSON
{
|
|
"intent": "Establish the safety net for the testsAndMisc restructure: a script that inventories every live reference into the repo, and the directory-depth gate written early as a dry run so the flattening work can be sized before any file moves.",
|
|
"scope": [
|
|
"meta/scripts/report_live_state.sh (new)",
|
|
"meta/scripts/check_directory_depth.sh (new, NOT yet wired into pre-commit)",
|
|
"docs/restructure-live-state.md (new)",
|
|
"Non-goal: no archives, extractions or moves in this commit",
|
|
"Non-goal: the depth gate is deliberately not enforced yet - the tree does not conform"
|
|
],
|
|
"changes": [
|
|
"report_live_state.sh enumerates systemd units, /etc config and $HOME symlinks that name an absolute path inside the repo; --check exits 1 while any remain, making it the post-move gate.",
|
|
"check_directory_depth.sh enforces a 2-directory cap, modelled on check_file_length.sh (--all/per-file, EXCLUDED_PREFIXES). Exempts third_party/, docs/superpowers/, .github/skills/ by prefix and any lib/ or tests/ path segment, matched as whole segments so libvirt/ and lib.sh are unaffected.",
|
|
"docs/restructure-live-state.md records the baseline inventory (6 systemd units, 2 /etc guard-lib targets, 19 symlinks) plus the depth dry-run sizing."
|
|
],
|
|
"verification": [
|
|
{
|
|
"command": "./meta/scripts/report_live_state.sh",
|
|
"result": "pass",
|
|
"evidence": "Reported 6 systemd units (media-organizer, dns-blocklist-refresh, endurain-import, kcd2-dice-build, morning-routine, syncyomi-guard), 2 /etc/guard-lib/targets/*.conf plugin paths, and 19 symlinks under ~/.config/i3blocks (13), ~/.local/bin (3), ~/.oh-my-zsh/custom (3)."
|
|
},
|
|
{
|
|
"command": "./meta/scripts/report_live_state.sh --check; echo $?",
|
|
"result": "pass",
|
|
"evidence": "Exit code 1 with 'live references into /home/kuhy/testsAndMisc remain', which is correct at baseline since nothing has moved yet."
|
|
},
|
|
{
|
|
"command": "14 hand-built path cases through check_directory_depth.sh",
|
|
"result": "pass",
|
|
"evidence": "a/b/c.sh=0, a/b/c/d.sh=1, boot_recovery/tests/lib/x.sh=0, focus_policy/tests/test_model.py=0, meta/scripts/lib/trace_stubs.sh=0, meta/scripts/fixtures/mutations/monitor.json=1, third_party+docs/superpowers+.github/skills prefixes=0. False-positive guards: a/b/libvirt/c.sh=1 and a/b/c/lib.sh=1 both correctly NOT exempt."
|
|
},
|
|
{
|
|
"command": "./meta/scripts/check_directory_depth.sh --all",
|
|
"result": "fail (expected - dry run only, gate not wired)",
|
|
"evidence": "556 violations at baseline. 349 disappear with the planned archives/extractions; 207 remain as the step D worklist, dominated by linux_configuration/scripts/single_use (~130)."
|
|
},
|
|
{
|
|
"command": "pre-commit run --files meta/scripts/check_directory_depth.sh meta/scripts/report_live_state.sh docs/restructure-live-state.md",
|
|
"result": "pass",
|
|
"evidence": "All hooks passed, including shellcheck, the 250-line file cap, and the shell-coverage ratchet."
|
|
}
|
|
],
|
|
"risks": [
|
|
"report_live_state.sh reads /etc without sudo, so a root-only-readable reference would be missed; every reference found so far is world-readable.",
|
|
"The symlink scan is depth-limited to 4 under $HOME, which covers all known locations but would miss a deeper one.",
|
|
"check_directory_depth.sh is intentionally not wired into pre-commit yet; wiring it now would block every unrelated commit, exactly as the file-length-cap comment warns."
|
|
],
|
|
"rollback": [
|
|
"git revert the commit; all three files are new and nothing sources them yet.",
|
|
"Confirm pre-commit run --all-files still passes, since no existing hook or workflow references these scripts."
|
|
]
|
|
}
|