Fix link checker CI by excluding Fumadocs framework patterns

[Copilot]

Lychee link checker was failing with 272 errors because it treated Fumadocs framework files and routing patterns as broken file paths.

Fumadocs uses meta.json files containing page identifiers ("agent", "orchestration") and relative links (./agent) that resolve to .mdx files at runtime. Lychee attempted to validate these as file:// paths without extensions.

Changes

• .lycheeignore: Added **/meta.json and **/meta.cn.json patterns
• check-links.yml: Added explicit --exclude-path flags for meta files
• lychee.toml: Excluded file://**/content/docs/** pattern to skip Fumadocs relative links

External HTTP/HTTPS link checking remains unchanged.

Original prompt

引用: https://github.com/objectstack-ai/spec/actions/runs/21434498273/job/61721754472#step:3:1

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
spec	Ready	Preview, Comment	Jan 28, 2026 10:45am

[Copilot]

Pull request overview

Updates Lychee configuration to avoid false positives from Fumadocs metadata/routing patterns that Lychee interprets as broken local file links during CI.

Changes:

• Added ignore patterns for Fumadocs meta.json / meta.cn.json.
• Added workflow-level --exclude-path rules for Fumadocs meta files.
• Excluded file:// checks under content/docs to skip Fumadocs runtime-resolved relative links.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
lychee.toml	Adds a broad file://**/content/docs/** exclusion intended to suppress Fumadocs runtime route false positives.
.lycheeignore	Adds ignore globs for meta.json and meta.cn.json.
.github/workflows/check-links.yml	Adds --exclude-path flags for meta files in the Lychee CI invocation.

[Copilot]

The new exclude pattern file://**/content/docs/** is very broad and will match all file:// URLs under content/docs (including the remapped /docs/... links that this config is intended to validate). That likely disables internal doc link validation entirely and leaves only external HTTP/HTTPS checks. Consider narrowing this to only the problematic extensionless routes (e.g., links that don’t end with .md/.mdx) or adding a remap strategy that appends .mdx/.md for Fumadocs-style ./agent routes, so existing internal link checks remain effective.

[Copilot]

--exclude-path '**/meta.json' / --exclude-path '**/meta.cn.json' appear redundant with the current invocation because the inputs being scanned are only content/**/*.md, content/**/*.mdx, and README.md (so no meta*.json files are included). If the intent is to prevent lychee from parsing those JSON files, either remove these flags for clarity or broaden the input globs to include the JSON files and keep the excludes.

Suggested change

	--exclude-path '**/meta.json'
	--exclude-path '**/meta.cn.json'