Skip to content

Harden root doc contract checks against whitespace and EOL variance#1

Merged
travisjneuman merged 2 commits intomainfrom
codex/fix-github-action-failure
Feb 16, 2026
Merged

Harden root doc contract checks against whitespace and EOL variance#1
travisjneuman merged 2 commits intomainfrom
codex/fix-github-action-failure

Conversation

@travisjneuman
Copy link
Copy Markdown
Owner

Motivation

  • The root-doc validator was brittle and could fail CI due to minor formatting differences (leading blank lines, CRLF endings, or incidental whitespace), so it was hardened to avoid false negatives while keeping the contract strict.

Description

  • Added a normalize_line helper and made the home-line detection read the second non-empty line, and updated Next/source heading regexes and next-link extraction to tolerate CRLF and surrounding whitespace so the validator is robust across environments.

Testing

  • Ran ./tools/check_root_doc_contract.sh, bash -n tools/check_root_doc_contract.sh, and the full suite via ./tools/run_all_curriculum_checks.sh, and all checks passed including markdown link checks, root/level/project contract checks, portable path checks, project Python comment checks, and smoke runs (core smoke 11/11 and elite smoke 3/3).

Codex Task

@travisjneuman travisjneuman merged commit 83c9a7e into main Feb 16, 2026
2 of 4 checks passed
@travisjneuman travisjneuman deleted the codex/fix-github-action-failure branch February 16, 2026 23:29
travisjneuman added a commit that referenced this pull request Feb 19, 2026
Harden root doc contract checks against whitespace and EOL variance
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant