Skip to content

docs: fix broken links and lychee resolution errors#474

Merged
yacosta738 merged 5 commits into
mainfrom
fix/broken-links-12950876164370050822
Apr 10, 2026
Merged

docs: fix broken links and lychee resolution errors#474
yacosta738 merged 5 commits into
mainfrom
fix/broken-links-12950876164370050822

Conversation

@yacosta738
Copy link
Copy Markdown
Contributor

This PR fixes all 21 broken link errors reported by Lychee.

Key changes:

  1. Lychee Configuration: Updated lychee.toml to handle local file:// URI resolution for internal package imports. The previous anchored patterns failed when Lychee converted CSS imports into absolute file paths. Added @fontsource to exclusions.
  2. Changelog: Fixed a 404 comparison link by pointing to the correct base tag v0.5.0 instead of the non-existent v1.0.0.

Fixes #464


PR created automatically by Jules for task 12950876164370050822 started by @yacosta738

- Update lychee.toml to use unanchored regex patterns for internal CSS
  imports and Tailwind directives to correctly handle local file URI
  resolution.
- Add @fontsource to Lychee exclusions to ignore font package
  references in CSS.
- Correct the version comparison link in CHANGELOG.md from
  v1.0.0...v2.0.0 to v0.5.0...v2.0.0 as v1.0.0 does not exist.
@google-labs-jules
Copy link
Copy Markdown
Contributor

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Apr 10, 2026

Deploying corvus with  Cloudflare Pages  Cloudflare Pages

Latest commit: da135ad
Status: ✅  Deploy successful!
Preview URL: https://8e53e046.corvus-42x.pages.dev
Branch Preview URL: https://fix-broken-links-12950876164.corvus-42x.pages.dev

View logs

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 10, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Updated changelog compare range to start from v0.5.0 and tightened lychee link-checker exclude regexes, adding an exclusion for @fontsource imports.

Changes

Cohort / File(s) Summary
Changelog
CHANGELOG.md
Changed v2.0.0 compare link range from v1.0.0v0.5.0 to fix a broken GitHub compare URL.
Link checker config
lychee.toml
Reworked exclude patterns: replaced ^@corvus/shared/.* with ^@corvus/shared/, changed ^tailwindcss$ → `^tailwindcss(/

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title follows Conventional Commit style with 'docs:' prefix and clearly describes the fix for broken links and lychee resolution errors.
Description check ✅ Passed The description covers key changes, links the related issue, and explains the purpose, but some template sections remain unfilled despite the checklist being marked complete.
Linked Issues check ✅ Passed The PR adequately addresses all coding requirements from issue #464: fixing the 404 link in CHANGELOG.md by correcting the tag reference, and updating lychee.toml patterns to handle file:// URI resolution for internal imports and @fontsource packages.
Out of Scope Changes check ✅ Passed All changes are directly scoped to resolving the 21 broken-link errors: CHANGELOG.md tag correction and lychee.toml exclusion pattern updates for CSS imports and @fontsource packages.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/broken-links-12950876164370050822

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

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 10, 2026

✅ Contributor Report

User: @yacosta738
Status: Passed (12/13 metrics passed)

Metric Description Value Threshold Status
PR Merge Rate PRs merged vs closed 90% >= 30%
Repo Quality Repos with ≥100 stars 0 >= 0
Positive Reactions Positive reactions received 10 >= 1
Negative Reactions Negative reactions received 0 <= 5
Account Age GitHub account age 3086 days >= 30 days
Activity Consistency Regular activity over time 108% >= 0%
Issue Engagement Issues with community engagement 0 >= 0
Code Reviews Code reviews given to others 539 >= 0
Merger Diversity Unique maintainers who merged PRs 2 >= 0
Repo History Merge Rate Merge rate in this repo 91% >= 0%
Repo History Min PRs Previous PRs in this repo 221 >= 0
Profile Completeness Profile richness (bio, followers) 90 >= 0
Suspicious Patterns Spam-like activity detection 1 N/A

Contributor Report evaluates based on public GitHub activity. Analysis period: 2025-04-10 to 2026-04-10

@yacosta738 yacosta738 marked this pull request as ready for review April 10, 2026 10:20
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@lychee.toml`:
- Around line 45-47: The exclusion regexes '.*@corvus/shared/.*',
'.*tailwindcss.*', and '.*@fontsource.*' are too broad and are matching external
https links; update them to only match npm package import paths by anchoring and
constraining the patterns to package-name formats (e.g., require leading
`@/package` segments and/or start/end anchors so they match only package
specifiers like `@corvus/shared/`... , tailwindcss (package), or
`@fontsource/`<pkg>), replacing the loose '.*' wrappers with precise anchors and
path separators so legitimate URLs (like https://tailwindcss.com/...) are no
longer excluded.
🪄 Autofix (Beta)

✅ Autofix completed


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: ac67e311-1800-464a-90d6-4521845d2452

📥 Commits

Reviewing files that changed from the base of the PR and between 5afd58b and 6f53374.

📒 Files selected for processing (2)
  • CHANGELOG.md
  • lychee.toml
📜 Review details
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)
  • GitHub Check: sonar
  • GitHub Check: pr-checks
  • GitHub Check: submit-gradle
  • GitHub Check: Cloudflare Pages
🧰 Additional context used
📓 Path-based instructions (2)
**/*.{md,mdx}

⚙️ CodeRabbit configuration file

**/*.{md,mdx}: Verify technical accuracy and that docs stay aligned with code changes.
For user-facing docs, check EN/ES parity or explicitly note pending translation gaps.

Files:

  • CHANGELOG.md
**/*

⚙️ CodeRabbit configuration file

**/*: Security first, performance second.
Validate input boundaries, auth/authz implications, and secret management.
Look for behavioral regressions, missing tests, and contract breaks across modules.

Files:

  • CHANGELOG.md
  • lychee.toml
🔇 Additional comments (1)
CHANGELOG.md (1)

23-23: Compare-link base correction looks correct.

The v0.5.0...v2.0.0 range aligns with the broken-link fix objective and is the right changelog metadata update.

As per coding guidelines, "Verify technical accuracy and that docs stay aligned with code changes."

Comment thread lychee.toml Outdated
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 10, 2026

Note

Autofix is a beta feature. Expect some limitations and changes as we gather feedback and continue to improve it.

Fixes Applied Successfully

Fixed 1 file(s) based on 1 unresolved review comment.

Files modified:

  • lychee.toml

Commit: e13a2187c5274ff234c391d1ed7bb251fd5dd9f2

The changes have been pushed to the fix/broken-links-12950876164370050822 branch.

Time taken: 2m 12s

Fixed 1 file(s) based on 1 unresolved review comment.

Co-authored-by: CodeRabbit <noreply@coderabbit.ai>
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@lychee.toml`:
- Line 47: The exclude regex '^@fontsource/' in lychee.toml doesn't match
imports like '@fontsource-variable/space-grotesk'; update the pattern to cover
both variants by replacing '^@fontsource/' with a regex that accepts the
optional "-variable" segment (for example '^@fontsource(-variable)?/'), so the
exclude will match both '@fontsource/...' and '@fontsource-variable/...'.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 45ec23c3-743f-44e5-a093-08de84bc1d2c

📥 Commits

Reviewing files that changed from the base of the PR and between 6f53374 and e13a218.

📒 Files selected for processing (1)
  • lychee.toml
📜 Review details
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)
  • GitHub Check: sonar
  • GitHub Check: pr-checks
  • GitHub Check: submit-gradle
  • GitHub Check: Cloudflare Pages
🧰 Additional context used
📓 Path-based instructions (1)
**/*

⚙️ CodeRabbit configuration file

**/*: Security first, performance second.
Validate input boundaries, auth/authz implications, and secret management.
Look for behavioral regressions, missing tests, and contract breaks across modules.

Files:

  • lychee.toml

Comment thread lychee.toml Outdated
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: Yuniel Acosta Pérez <33158051+yacosta738@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@lychee.toml`:
- Around line 45-49: The lychee exclusion list currently uses the pattern
'^@corvus/shared/' which only matches subpaths and is duplicated; update the
pattern to match both the bare package and subpaths (e.g., change
'^@corvus/shared/' to a single pattern like '^@corvus/shared(?:$|/)') and remove
the duplicate entries (also dedupe any repeated '^tailwindcss(/|$)' lines) so
the bare imports referenced in useGateway.ts, useConfig.ts, useCostGovernance.ts
and marketing index.astro are correctly excluded.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 6ea0338b-6aaf-415d-8a0e-4ae6d834ecbe

📥 Commits

Reviewing files that changed from the base of the PR and between e13a218 and f971343.

📒 Files selected for processing (1)
  • lychee.toml
📜 Review details
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)
  • GitHub Check: submit-gradle
  • GitHub Check: sonar
  • GitHub Check: pr-checks
  • GitHub Check: Cloudflare Pages
🧰 Additional context used
📓 Path-based instructions (1)
**/*

⚙️ CodeRabbit configuration file

**/*: Security first, performance second.
Validate input boundaries, auth/authz implications, and secret management.
Look for behavioral regressions, missing tests, and contract breaks across modules.

Files:

  • lychee.toml

Comment thread lychee.toml Outdated
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: Yuniel Acosta Pérez <33158051+yacosta738@users.noreply.github.com>
@yacosta738 yacosta738 merged commit a3fe351 into main Apr 10, 2026
12 checks passed
@yacosta738 yacosta738 deleted the fix/broken-links-12950876164370050822 branch April 10, 2026 11:52
@sonarqubecloud
Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: broken links report

1 participant