Skip to content

Add automated link validation workflow with configurable scope#27

Merged
zaxlofful merged 9 commits intomainfrom
copilot/add-link-validation-workflow
Feb 1, 2026
Merged

Add automated link validation workflow with configurable scope#27
zaxlofful merged 9 commits intomainfrom
copilot/add-link-validation-workflow

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Feb 1, 2026

Implements automated link checking across the repository with issue creation for broken links.

Implementation

Workflow (.github/workflows/check-links.yml)

  • Scheduled weekly runs (Mondays 9 AM UTC)
  • Manual trigger with scope selection: external (default), internal, or all
  • Scans Markdown, HTML, JSON, and Python files
  • Auto-creates/updates issues with link-check label when links break
  • Duplicate issue detection to avoid noise

Link Checker

  • Uses lycheeverse/lychee-action@v2 (Rust-based, async)
  • Dynamic lychee.toml generation based on scope
  • 3 retries with 2s backoff, 20s timeout, 8 concurrent requests
  • Excludes Python build artifacts and version control directories

Scope Behavior

  • external: Excludes links to this repository via exclude_path regex
  • internal/all: Checks all links (no filtering applied)

Issue Format

## 🔗 Broken Links Detected

**Check Scope:** external links
**Workflow Run:** [link]
**Date:** 2026-02-01 19:21:23 UTC

### Broken Links Report
[lychee output with detailed breakdown]

### How to Fix
[actionable steps]

Documentation

  • Added workflow badge and CI/CD section entry in README
  • Documented scope options and manual trigger usage
Original prompt

Create a workflow that will look through the entire repository for links to other things that are not our own repository actually include all links, scratch only outside links, although I guess make it a possibility that you could either select outside links or internal links, anyways the purpose of the workflow is to check these links and whether they are still valid, if they are no longer valid, they need to be turned into an issue and let us know that it's not valid


💡 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.

Co-authored-by: zaxlofful <33877007+zaxlofful@users.noreply.github.com>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages bot commented Feb 1, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
❌ Deployment failed
View logs
simplewish 6b3d2cd Feb 01 2026, 11:47 PM

Copilot AI and others added 6 commits February 1, 2026 19:24
Co-authored-by: zaxlofful <33877007+zaxlofful@users.noreply.github.com>
Co-authored-by: zaxlofful <33877007+zaxlofful@users.noreply.github.com>
Co-authored-by: zaxlofful <33877007+zaxlofful@users.noreply.github.com>
Co-authored-by: zaxlofful <33877007+zaxlofful@users.noreply.github.com>
Co-authored-by: zaxlofful <33877007+zaxlofful@users.noreply.github.com>
Co-authored-by: zaxlofful <33877007+zaxlofful@users.noreply.github.com>
Copilot AI changed the title [WIP] Add workflow for validating all repository links Add automated link validation workflow with configurable scope Feb 1, 2026
Copilot AI requested a review from zaxlofful February 1, 2026 19:31
@zaxlofful zaxlofful marked this pull request as ready for review February 1, 2026 19:51
Copilot AI review requested due to automatic review settings February 1, 2026 19:51
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR implements automated link validation across the repository with configurable scope options and automatic issue creation for broken links.

Changes:

  • Adds .github/workflows/check-links.yml workflow with scheduled weekly runs and manual triggers
  • Integrates lycheeverse/lychee-action@v2 for link checking with retry logic and timeout configuration
  • Implements three scope options: external (default), internal, and all
  • Adds automatic issue creation/update with link-check label and duplicate detection
  • Updates README.md with workflow badge and comprehensive documentation

Reviewed changes

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

File Description
.github/workflows/check-links.yml New workflow for automated link validation with dynamic lychee.toml generation, broken link detection, and issue management
README.md Adds Check Links badge and detailed documentation of the link checker workflow, including scope options and usage instructions

Copy link
Copy Markdown
Owner

@zaxlofful zaxlofful left a comment

Choose a reason for hiding this comment

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

Verify Links are still valid

@zaxlofful zaxlofful self-requested a review February 1, 2026 23:44
@zaxlofful zaxlofful merged commit db373fc into main Feb 1, 2026
2 of 3 checks passed
@zaxlofful zaxlofful deleted the copilot/add-link-validation-workflow branch February 1, 2026 23:47
@zaxlofful
Copy link
Copy Markdown
Owner

@copilot : failed again

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.

3 participants