{ "title": "Phase 2: enforce the 250-line cap and mirror Shell tests before push", "objective": "Make the 250-line cap a gate rather than a convention, and close the loop that let shell changes pass every local check and still go red on push. Implements both halves of the user's answer to the CI-green fork: (a) refuse to build on a red main, (b) run the Shell tests workflow's local equivalent on pre-push.", "acceptance_criteria": [ "check_file_length.sh --all reports zero violations before the hook is wired; the gate must not land while any file is over the cap.", "The file-length hook demonstrably BLOCKS a deliberately over-cap file and passes once it is removed — proven, not assumed.", "The CI-baseline hook fails closed on a definitively red required workflow and exits 0 on every undeterminable case: no gh, unauthenticated, offline, inside GitHub Actions, CI_GREEN_SKIP=1.", "ci_mirror runs every lib/tests/run_all.sh and the workflow's side-effect-free test list, with that list derived from shell-tests.yml rather than duplicated, and fails if the derivation yields nothing.", "shellcheck passes on both scripts with no suppression added." ], "out_of_scope": [ "Mirroring the Arch-container half of shell-tests: it needs root and an Arch userland.", "Requiring python-tests.yml to be green — it is path-filtered and would produce false reds on shell-only commits.", "Phase 3, the repo-wide shell coverage gate, which the user has not yet scoped." ], "verifier": "pre-commit run file-length-cap --all-files with a 261-line probe staged (must exit 1 naming the file) and again after removing it (must pass); pre-commit run ci-baseline-green --all-files against green main, plus the CI_GREEN_SKIP and GITHUB_ACTIONS skip paths; the awk parse compared against the workflow's own list; shellcheck on both scripts." }