evolith_tracker/.github/workflows/docs.yml at main · beyondnetcode/evolith_tracker · 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
name: Documentation Validation

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

permissions:
  contents: read

jobs:
  validate:
    name: Validate documentation
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "20"

      - name: Validate docs
        run: node .harness/scripts/validate-docs.mjs

      - name: Check bilingual parity
        run: node .harness/scripts/check-bilingual-parity.mjs

      - name: Validate root cleanliness
        run: node .harness/scripts/validate-root-cleanliness.mjs

      # GT-617 — los inventarios documentales se DERIVAN del código, no se mantienen a mano.
      # Falla el build a proposito: la insignia de ADRs, el mapa de schemas y el listado de
      # robots llevaban meses desfasados (30 vs 54 decisiones, 10 vs 8 schemas, 3 vs 12
      # robots) y nadie lo noto, porque nada los contrastaba con la fuente. Corre en segundos
      # y no necesita ni base de datos ni SDK.
      - name: Documentation inventory must match the code
        run: node .harness/scripts/doc-inventory.mjs --check

      - name: Check orphan bilingual files
        # El escalar plano de `run:` no puede contener ": " — rompia el parseo del workflow y
        # por eso este fichero nunca llego a ejecutarse (374 ejecuciones, 0 exitosas). Bloque
        # literal para que el texto quede fuera del analisis YAML.
        run: |
          node .harness/scripts/check-orphan-bilingual.mjs 2>/dev/null || echo "Skipped - script not available"

      - name: Generate coverage dashboard
        run: node .harness/scripts/coverage-dashboard.mjs

      - name: Upload coverage report
        uses: actions/upload-artifact@v4
        if: always()
        with:
          name: coverage-report
          path: COVERAGE_REPORT.md
          retention-days: 30

      - name: Report bilingual coverage
        run: node .harness/scripts/bilingual-coverage.mjs