Fix Ref

Overview

Replace navigational page references with verified Markdown links. Work file by file, resolve each page reference to a real section, and replace each match individually instead of using blind global edits.

Workflow

Step 1: Resolve Scope and Source Context

1. Default scope to docs/src/content/docs/**/*.md unless the user gives a narrower target.
2. Read the target files and the nearby headings before editing.
3. If source mapping is needed, use the extracted markdown, table of contents, or source PDF to map printed page numbers to actual section titles or document routes.

Step 2: Detect Candidate Patterns

Search for page-reference patterns such as: