openclaw/.github/workflows/docs-external-links.yml at main · fuller-stack-dev/openclaw · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
name: Docs External Link Audit

on:
  schedule:
    - cron: "47 7 * * 1"
  workflow_dispatch:

permissions:
  contents: read

concurrency:
  group: docs-external-link-audit
  cancel-in-progress: false

jobs:
  audit:
    if: github.repository == 'openclaw/openclaw'
    runs-on: ubuntu-24.04
    timeout-minutes: 45
    steps:
      - name: Checkout
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          persist-credentials: false

      - name: Setup Node.js and pnpm
        uses: ./.github/actions/setup-node-env
        with:
          cache-mode: restore
          install-bun: "false"
          install-deps: "false"

      - name: Install link audit dependencies
        run: pnpm install --filter . --frozen-lockfile --ignore-scripts

      - name: Prepare MDX link audit input
        run: >-
          node scripts/docs-link-audit.mjs
          --prepare-external-links
          .artifacts/docs-external-links/mdx

      - name: Audit external links
        uses: lycheeverse/lychee-action@e7477775783ea5526144ba13e8db5eec57747ce8 # v2.9.0
        with:
          args: >-
            --no-progress
            --base-url https://docs.openclaw.ai
            --exclude-all-private
            --accept '100..=399,401,403,429,500..=599'
            --accept-timeouts
            --max-retries 2
            --retry-wait-time 2
            --timeout 20
            --scheme http
            --scheme https
            --exclude '^https://docs\.openclaw\.ai/'
            --exclude '^https://github\.com/openclaw/maintainers/'
            --exclude '^https://(claude\.ai|help\.openai\.com|openai\.com|platform\.openai\.com|support\.discord\.com|www\.npmjs\.com|www\.raspberrypi\.com)/'
            './README.md'
            './CONTRIBUTING.md'
            './SECURITY.md'
            './docs/**/*.md'
            './docs/**/*.mdx'
            './docs/docs.json'
            './.artifacts/docs-external-links/mdx/**/*.md'
            './.artifacts/docs-external-links/mdx/**/*.mdx'
          fail: false
          failIfEmpty: true
          format: markdown
          output: .artifacts/docs-external-links/report.md

      # The main pass follows redirects. This pass stops at the first response
      # so permanent moves remain visible without flagging temporary redirects.
      - name: Report permanent redirects
        if: always()
        continue-on-error: true
        run: >-
          lychee
          --no-progress
          --base-url https://docs.openclaw.ai
          --exclude-all-private
          --accept '100..=300,302..=307,309..=599'
          --accept-timeouts
          --max-retries 2
          --retry-wait-time 2
          --timeout 20
          --max-redirects 0
          --scheme http
          --scheme https
          --exclude '^https://docs\.openclaw\.ai/'
          --exclude '^https://github\.com/openclaw/maintainers/'
          --exclude '^https://(claude\.ai|help\.openai\.com|openai\.com|platform\.openai\.com|support\.discord\.com|www\.npmjs\.com|www\.raspberrypi\.com)/'
          --format markdown
          --output .artifacts/docs-external-links/permanent-redirects.md
          './README.md'
          './CONTRIBUTING.md'
          './SECURITY.md'
          './docs/**/*.md'
          './docs/**/*.mdx'
          './docs/docs.json'
          './.artifacts/docs-external-links/mdx/**/*.md'
          './.artifacts/docs-external-links/mdx/**/*.mdx'

      - name: Upload audit report
        if: always()
        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
        with:
          name: docs-external-link-audit
          path: .artifacts/docs-external-links
          include-hidden-files: true
          if-no-files-found: warn
          retention-days: 14