Skip to content

Conversation

@Data-Wise
Copy link
Owner

Summary

  • Update index page "What's New" callout from Teach Doctor v2 to v6.7.0 Math Preflight + Quality Gates

Test plan

  • mkdocs build --strict passes

🤖 Generated with Claude Code

Test User and others added 4 commits February 9, 2026 14:04
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* feat(deploy): add display math preflight validation

Pure ZSH state machine that detects blank lines and unclosed $$ blocks
in .qmd files during deploy preflight. Replaces inline Python dependency.

- _check_math_blanks: returns 0 (clean), 1 (blank line), 2 (unclosed)
- Path resolution via git rev-parse --show-toplevel
- CI mode blocks deploy on math issues; interactive mode warns only
- Actionable fix messages (no reference to nonexistent scripts)
- 41 tests: 13 unit, 13 E2E (sandboxed git repos), 15 dogfood (demo course)
- Docs: deploy guide, refcard, API reference updated

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(deploy): declare loop vars local, add status line for no-qmd case

- Declare _line and _stripped as local in _check_math_blanks
- Move _abs_path and _qmd_file declarations before loop body
- Print "[ok] Display math blocks valid" even when no .qmd files changed

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(preflight): add pre-commit math validation via lint-staged

Wire _check_math_blanks into the pre-commit hook so display-math
issues (blank lines in $$ blocks, unclosed $$ blocks) are caught at
commit time, not just deploy time.

- scripts/check-math.zsh: standalone wrapper for lint-staged
- package.json: add *.qmd lint-staged entry
- docs/guides/QUALITY-GATES.md: comprehensive validation layer docs
- mkdocs.yml: add Quality Gates nav entry
- TEACH-DEPLOY-GUIDE.md: cross-reference to pre-commit gate

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: update CLAUDE.md for math preflight feature

- Test file count 137 → 143
- Add scripts/ dir and check-math.zsh to project structure
- Add deploy preflight mention to teaching subcommands
- Update last-updated date

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Test User <test@example.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@Data-Wise Data-Wise merged commit 1ba3e80 into main Feb 10, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant