testsAndMisc/docs/superpowers/contracts/linux-config-batch7-2026-08-16.json
Krzysztof kuhy Rudnicki 63650fbc45 Split offline docs and arch optimiser; defer libre_translate
setup_offline_docs.sh 713 -> 121 across six libs, carved one language at
a time since the first cut left offline_cpp at 545. optimize_arch_
desktop.sh 623 -> 118.

Two recurring traps again: a script with no SCRIPT_DIR at all, and libs
that chained rather than being sourced from the entry. Both now checked
for routinely.

libre_translate.sh is reverted and stays at 488. Exporting GENERATED to
fix one SC2034 revealed eighteen more - when a fix uncovers more of the
same, the seam is imaginary, not the fix wrong.

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

19 lines
1.3 KiB
JSON

{
"title": "Split setup_offline_docs.sh and optimize_arch_desktop.sh, deferring libre_translate.sh",
"objective": "Bring setup_offline_docs.sh (713) and optimize_arch_desktop.sh (623) under the 250-line cap, and confirm that a script with many globals written in one half and read in the other cannot be split cleanly.",
"acceptance_criteria": [
"Both entry scripts and all seven new libs are at most 250 lines.",
"The pre-commit shellcheck hook passes on every touched file, with no new suppression and no disable directive.",
"No lib sources a sibling: each entry sources every lib directly.",
"The stubbed run reports every moved function as defined for both scripts.",
"No script is executed. One downloads documentation archives, the other writes sysctl and udev settings.",
"libre_translate.sh is fully restored to 488 lines, leaving the unrelated lib already in that directory in place."
],
"out_of_scope": [
"Executing any download or tuning step.",
"libre_translate.sh, which has nineteen globals crossing any seam.",
"Changing what any script does when run."
],
"verifier": "meta/scripts/verify_shell_split.sh per script, plus pre-commit run --files, plus check_file_length.sh, plus ls of the shared lib/ directory after the revert."
}