testsAndMisc/docs/restructure-live-state.md
Krzysztof kuhy Rudnicki 3cd42a4451 Restructure step 0: live-state inventory + depth gate dry run
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
2026-08-23 16:59:54 +02:00

6.6 KiB

Live state pointing into testsAndMisc

Generated by meta/scripts/report_live_state.sh at 2026-08-23T16:56:34+02:00. Baseline commit: f4535b6b

This is the checklist for the repo restructure. Every entry below names an absolute path inside this repo; when that path moves, the referring file must be repointed in the same step. Re-run the script with --check after each move to prove nothing was left behind.

## systemd units
  /etc/systemd/system/dns-blocklist-refresh.service
      7:ExecStart=/home/kuhy/testsAndMisc/linux_configuration/scripts/single_use/features/setup_dns_blocker.sh refresh
  /etc/systemd/system/media-organizer.service
      10:ExecStart=/home/kuhy/testsAndMisc/linux_configuration/scripts/single_use/utils/organize_downloads.sh
  /home/kuhy/.config/systemd/user/endurain-import.service
      3:Documentation=file:///home/kuhy/testsAndMisc/endurain/README.md
      11:WorkingDirectory=/home/kuhy/testsAndMisc
      21:ExecStart=/usr/bin/bash -c 'ENDURAIN_API_KEY="$(cat /home/kuhy/testsAndMisc/endurain/.api_key)" /home/kuhy/testsAndMisc/.venv/bin/python -m python_pkg.endurain_import'
  /home/kuhy/.config/systemd/user/kcd2-dice-build.service
      7:WorkingDirectory=/home/kuhy/testsAndMisc/kcd2_dice_solver
      8:ExecStart=/home/kuhy/testsAndMisc/kcd2_dice_solver/deploy_build.sh
  /home/kuhy/.config/systemd/user/morning-routine.service
      13:Environment=PYTHONPATH=%h/testsAndMisc
      16:WorkingDirectory=%h/testsAndMisc
  /home/kuhy/.config/systemd/user/syncyomi-guard.service
      8:WorkingDirectory=/home/kuhy/testsAndMisc
      9:Environment=PYTHONPATH=/home/kuhy/testsAndMisc

## /etc references
  /etc/guard-lib/targets/nsswitch.conf
      4:PLUGIN="/home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/hosts/guard/plugins/nsswitch-plugin.sh"
  /etc/guard-lib/targets/resolved.conf
      4:PLUGIN="/home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/hosts/guard/plugins/resolved-plugin.sh"

## symlinks into the repo
  /home/kuhy/.config/i3blocks/claude_usage.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/claude_usage.sh
  /home/kuhy/.config/i3blocks/config -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/config
  /home/kuhy/.config/i3blocks/cpu_monitor.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/cpu_monitor.sh
  /home/kuhy/.config/i3blocks/disk.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/disk.sh
  /home/kuhy/.config/i3blocks/ethernet.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/ethernet.sh
  /home/kuhy/.config/i3blocks/gpu_monitor.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/gpu_monitor.sh
  /home/kuhy/.config/i3blocks/memory.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/memory.sh
  /home/kuhy/.config/i3blocks/motherboard_temp.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/motherboard_temp.sh
  /home/kuhy/.config/i3blocks/pc_startup_status.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/pc_startup_status.sh
  /home/kuhy/.config/i3blocks/persist_common.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/persist_common.sh
  /home/kuhy/.config/i3blocks/shutdown_countdown.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/shutdown_countdown.sh
  /home/kuhy/.config/i3blocks/time.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/time.sh
  /home/kuhy/.config/i3blocks/volume.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/periodic_background/i3-configuration/i3blocks/volume.sh
  /home/kuhy/.local/bin/keepass-open -> /home/kuhy/testsAndMisc/linux_configuration/scripts/single_use/features/keepass-open.sh
  /home/kuhy/.local/bin/line-speed-probe.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/diagnostics/line-speed-probe.sh
  /home/kuhy/.local/bin/steam-download-duty.sh -> /home/kuhy/testsAndMisc/linux_configuration/scripts/diagnostics/steam-download-duty.sh
  /home/kuhy/.oh-my-zsh/custom/calc-live.zsh -> /home/kuhy/testsAndMisc/linux_configuration/zsh/calc-live.zsh
  /home/kuhy/.oh-my-zsh/custom/claude-tty-fix.zsh -> /home/kuhy/testsAndMisc/linux_configuration/zsh/claude-tty-fix.zsh
  /home/kuhy/.oh-my-zsh/custom/token-savers.zsh -> /home/kuhy/testsAndMisc/linux_configuration/zsh/token-savers.zsh

Depth-cap dry run (step 0)

meta/scripts/check_directory_depth.sh --all at baseline:

Bucket Files
Total violations 556
Disappear with the archives/extractions 349
Remain — the step D worklist 207

Step D worklist by directory:

     36 linux_configuration/scripts/single_use/utils
     24 linux_configuration/scripts/single_use/features
     18 linux_configuration/scripts/single_use/misc/testsAndMisc-bash
     17 linux_configuration/scripts/single_use/fixes
     14 linux_configuration/scripts/single_use/fresh-install
     13 linux_configuration/scripts/periodic_background/i3-configuration/i3blocks
     10 linux_configuration/scripts/single_use/misc/testsAndMisc-bash/tools
      9 linux_configuration/C/atop_agg
      7 python_pkg/artgate/routes
      6 meta/scripts/fixtures/mutations
      6 meta/scripts/fixtures
      6 linux_configuration/scripts/single_use
      6 linux_configuration/docs/security-hardening
      5 linux_configuration/dwm/bin
      3 python_pkg/artgate/styles
      3 linux_configuration/scripts/diagnostics
      3 linux_configuration/scripts/boot_recovery
      2 linux_configuration/scripts/single_use/features/systemd
      2 linux_configuration/scripts/periodic_background/i3-configuration
      2 linux_configuration/scripts/periodic_background
      2 linux_configuration/scripts/gaming
      2 linux_configuration/scripts/boot_recovery/hooks
      2 linux_configuration/dwm/patches
      1 meta/scripts/run_all
      1 linux_configuration/zsh/scratchpad
      1 linux_configuration/scripts/single_use/utils/data
      1 linux_configuration/scripts/single_use/misc/testsAndMisc-bash/.vscode
      1 linux_configuration/scripts/single_use/feedback-appimage
      1 linux_configuration/scripts/periodic_background/i3-configuration/i3
      1 linux_configuration/scripts/meta
      1 linux_configuration/.github/workflows
      1 linux_configuration/docs/pacman-wrapper