[ptr727]

Promotes the #3426 markdown-it-py link reading from develop to main.

• #3635 Reads spec/validate.py's link targets, sections, and headings, and the README audit's reference definitions, through spec/fidelity_text.py and markdown-it-py. A definition resolves first-wins with folded lookup, as GitHub renders it, and code is content rather than links. The validator now runs under uv run --no-project --script.
• #3637 Reads backslash escapes in a definition's label and angle destination, so an escaped > no longer cuts a destination short and a label ending in an escaped backslash no longer raises. It answers both findings Copilot raised on this promotion.

Closes #3426

🤖 Generated with Claude Code

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration

• Source mode: Auto
• Repository: ptr727/ProjectTemplate
• Branch: develop
• File: .coderabbit.yaml
• Commit: 19548f4
• Layers: Repository YAML
• Review profile: CHILL
• Plan: Advanced
• Run ID: 1be5dbff-c614-46f7-b1b7-afa39c30a04b

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[Copilot]

🟡 Changes recommended

A moderate active issue remains because escaped characters in angle-bracket destinations can be truncated, causing valid links to be classified differently from GitHub’s rendering.

1 open issue

• Preserve escaped characters in angle destinations · New

What changed in this PR

Promotes the Markdown parsing migration from develop to main, replacing handwritten Markdown readers with markdown-it-py for validator and README audit behavior aligned with GitHub rendering.

Changes:

• Centralizes parsing of links, reference definitions, sections, headings, and fenced code in spec/fidelity_text.py.
• Updates validation and README audits to use folded, first-wins reference resolution.
• Adds parser-focused tests and updates the uv-based validator invocation in CI and documentation.

Review findings:

• Angle-bracket destinations containing escaped > characters may be truncated.
• Reference labels ending in an escaped backslash may cause definition parsing to fail.

File	Summary
tests/​test_spec_validate.py	Tests parser-backed validator behavior, carried links, fenced headings, and lazy imports.
tests/​test_fidelity_text.py	Tests link targets, definitions, folded labels, headings, and fenced code handling.
tests/​test_audit_helpers.py	Tests README reference resolution and first-wins behavior.
spec/​validate.py	Uses shared Markdown parsing for links, sections, and headings with lazy loading.
spec/​fidelity_text.py	Adds shared parser-backed link-target and reference-definition readers.
spec/​audit_markdown.py	Uses parser-backed definitions and folded reference lookup for README checks.
OPERATIONS.md	Documents the uv validator invocation and expanded parser responsibilities.
.github/​actions/​validate/​action.yml	Sets up uv and runs the validator with its inline dependencies.

_{Review effort: Lite}

[codecov]

Codecov Report

❌ Patch coverage is 98.59155% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 81.69%. Comparing base (e15559f) to head (19548f4).
⚠️ Report is 447 commits behind head on main.

Files with missing lines	Patch %	Lines
spec/validate.py	87.50%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3636      +/-   ##
==========================================
+ Coverage   81.63%   81.69%   +0.06%     
==========================================
  Files          26       26              
  Lines        9081     9111      +30     
==========================================
+ Hits         7413     7443      +30     
  Misses       1668     1668              

Flag	Coverage Δ
python-3.13	81.69% <98.59%> (+0.06%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[ptr727]

Answering the finding Copilot's review of 04bd8ae names in its body with no thread (1): #3636 (review)

• spec/fidelity_text.py:35 _DESTINATION, "Reference labels ending in an escaped backslash may cause definition parsing to fail." Fixed in 19548f4 (Read Backslash Escapes in a Definition's Label and Angle Destination #3637). The regex now pairs each backslash with the character after it inside the label, so [a\\]: one.md matches and reads one.md rather than raising AttributeError in link_definitions. The same test pins it.

[Copilot]

🟢 Approval recommended

No active review issues remain, so the parser migration and its related validation, audit, documentation, and regression-test changes are ready for approval.

No open issues 🎉

1 resolved since last review

• Preserve escaped characters in angle destinations

_{Review effort: Lite}