durable-workflow.github.io/.github/workflows/qualification.yml at main · durable-workflow/durable-workflow.github.io · 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
name: Documentation Qualification

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  workflow_dispatch:

permissions:
  contents: read

concurrency:
  group: documentation-qualification-${{ github.sha }}
  cancel-in-progress: false

jobs:
  executable-contracts:
    name: Executable documentation contracts
    runs-on: ubuntu-latest
    timeout-minutes: 20

    steps:
      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803  # v6
        with:
          fetch-depth: 0

      - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38  # v6
        with:
          node-version: 24
          cache: npm

      - name: Verify local Workflow conformance authority
        run: npm run check:platform-conformance-authority

      - name: Resolve published Workflow conformance ref
        id: published-workflow
        if: github.server_url == 'https://github.com'
        run: |
          node -e "process.stdout.write('ref=' + require('./scripts/workflow-platform-conformance-authority-lock.json').workflow_source_commit + '\n')" >> "$GITHUB_OUTPUT"

      - name: Checkout published Workflow conformance authority
        if: github.server_url == 'https://github.com'
        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803  # v6
        with:
          repository: ${{ github.repository_owner }}/workflow
          ref: ${{ steps.published-workflow.outputs.ref }}
          path: .published-workflow-authority
          persist-credentials: false

      - name: Verify published Workflow conformance authority
        if: github.server_url == 'https://github.com'
        env:
          WORKFLOW_PLATFORM_CONFORMANCE_MANIFEST_PATH: ${{ github.workspace }}/.published-workflow-authority/resources/platform-conformance-contract.json
        run: npm run check:platform-conformance-authority

      - name: Install documentation dependencies
        run: npm ci

      - name: Validate Node toolchain policy
        run: npm run check:node-toolchain

      - name: Build routes and validate links
        run: npm run docusaurus -- build

      - name: Install visual qualification browser
        run: npx --no-install playwright install --with-deps chromium

      - name: Enforce visual control reachability
        run: npm run check:visual-reachability

      - name: Upload visual qualification evidence
        if: ${{ always() && github.server_url == 'https://github.com' }}
        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7
        with:
          name: visual-reachability
          path: visual-reachability/
          if-no-files-found: warn
          retention-days: 14

      - name: Generate model retrieval surfaces
        run: |
          node scripts/generate-llms.js
          node scripts/generate-llms-full.js

      - name: Validate model retrieval surfaces
        run: npm run check:llms-ai-surfaces

      - name: Validate executable documentation contracts
        run: node scripts/check-executable-docs-contracts.js